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TECHNIQUES FOR PERMITTING ACCESS ACROSS A 
CONTEXT BARRIER IN A SMALL FOOTPRINT DEVICE 
USING GLOBAL DATA STRUCTURES 



CROSS-REFERENCES TO RELATED APPLICATIONS 
This application is related to U.S. Patent Application Serial Number 08/839,621 
filed April 15, 1997, entitled "VIRTUAL MACHINE WITH SECURELY 
DISTRIBUTED BYTE CODE VERIFICATION", in the name of inventors Moshe 
5 Levy and Judy Schwabe (Docket No. 50253-221/P3263), which application is 

incorporated herein by reference in its mtirety. 

This application is related to U.S. Patent Application Serial Numb^ 09/235,158 
filed January 22, 1999, entitled "TECHNIQUES FOR IMPLEMENTING SECURITY 
ON A SMALL FOOTPRINT DEVICE USING A CONTEXT BARRIER", in the name 
10 of inventors Joshua Susser, Mitchel B. Butler, and Andy Streich, (Docket No. S02S3- 
216/P3708), which application is incorporated herein by reference in its entirety. 

This application is related to U.S. Patent Application Serial Number 09/235,157 
filed January 22. 1999, entitled "TECHNIQUES FOR PERMITTING ACCESS 
ACROSS A CONTEXT BARRIER ON A SMALL FOOTPRINT DEVICE USING 
15 AN ENTRY POINT OBJECT", in the name of inventors Joshua Susser, Mitchel B. 
Butler, and Andy Streich, (Docket No. 50253-2 17/P3709), which application is 
incorporated herein by reference in its entirety. 

This application is related to U.S. Patent Application Serial Nxunber 09/235,155 
filed January 22, 1999, entifled "TECHNIQUES FOR PERMITTING ACCESS 
20 ACROSS A CONTEXT BARRIER ON A SMALL FOOTPRINT DEVICE USING 
RUN TIME ENVIRONMENT PRIVILEGES", in the name of inventors Joshua Susser, 
Mitchel B. Butler, and Andy Streich, (Docket No. 50253-2 18/P3710), which application 
is incorporated herein by reference in its mtirety. 

This application is related to U.S. Patent Application Serial Number 09/235,159 
25 filed January 22, 1999, entitied "TECHNIQUES FOR PERMITTING ACCESS 

ACROSS A CONTEXT BARRIER IN A SMALL FOOTPRINT USING SHARED 
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OBJECT INTERFACES", in the name of inventors Joshxia Susser, Mitchel B. Butter, 
and Andy Streich, (Docket No. 50253-22(VP3712), which application is incorporated 
herein by reference in its entirety. 

BACKGROUND OF THE INVENTION 

5 Field of the Invention 

The invention relates to computer security and more particularly to techniques 
for implementing a security on small footprint devices, such as smart cards. 

Description of Related Art 

A number of object oriented progranuning languages are well known in the art. 

10 Examples of these include the C++ language and the Smalltalk language. 

Another such object oriented language is the JAVA™ language. This language 
is described in the book Java™ Language Specification , by James Gosling et al. and 
published by Addison- Wesley. This work is incorporated herein by reference in its 
entirety. The JAVA™ language is particularly well suited to run on a Java™ Virtual 

15 Machine. Such a machine is described in the book Java™ Virtual Machine 

Specification , by Tim Lindholm and Frank Yellin which is also published by Addison- 
Wesley and which is also incorporated herein by reference in its entirety. 

A niunber of small footprint devices are also well known in the art. These 
include smart cards, cellular telephones, and various other small or miniature devices. 

20 Smart cards are similar in size and shape to a credit card but contain, typically, 

data processing capabilities within the card (e.g. a processor or logic performing 
processing functions) and a set of contacts through which programs, data and other 
communications with the smart card may be achieved. Typically, the set of contacts 
includes a power source connection and a return as well as a clock input, a reset input 

25 and a data port through which data communications can be achieved. 

Information can be written to a smart card and retrieved fi-om a smart card using 
a card acceptance device. A card acceptance device is typically a peripheral attached to 
a host computer and contains a card port, such as a slot, in to which a smart card can be 
inserted. Once inserted, contacts or brushes from a connector press against the surface 
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connection area on the smart card to provide power and to permit communications with 
the processor and memory typically found on a smart card. 

Smart cards and card acceptance devices (CADs) are the subject of extensive 
standardization efiforts, e.g. ISO 7816. 
S The use of firewalls to separate authorized from xmauthorized users is well 

known in the networic environment. For example, such a firewall is disclosed in U.S. 
Patent Application Serial No. 09/203,719, filed December 1, 1998 and entitled 
"AUTHENTICATED FIREWALL TUNNELLING FRAMEWORK" in the name of 
inventor David Brownell (Docket No. 50435-023/P2789/TJC), which application is 
1 0 incorporated herein by reference in its entirety. 

A subset of the full Java^ platform capabilities has been defined for small 
footprint de\dces, such as smart cards. This subset is called the Java Card^ platform. 
The uses of the Java Card™ platform are described in the following publications. 

JAVA CARD™ 2.0 - LANGUAGE SUBSET AND VIRTUAL MACHINE 
15 SPECMCATION; 

JAVA CARD™ 2.1 - APPLICATION PROGRAMMING INTERFACES; 

JAVA CARD™ 2.0 - PROGRAMMING CONCEPTS; 

JAVA CARD™ APPLET DEVELOPER'S GUIDE. 

These publications are incorporated herein by reference in their entirety. 
20 A working draft of ISO 7816 — Part 1 1 has been circulated for comment. That 

draft specifies standards for permitting separate execution contexts to operate on a smart 
card. A copy of that working draft is hereby incorporated by reference in its entirety. 

The notion of an execution context is well known in computer science. 
Generally speaking, the use of multiple execution contexts in a computing environment 
25 provides a way to separate or isolate different program modules or processes firom one 
another, so that each can operate without undue interference from the others. 
Interactions —if any— between different contexts are deliberate rather than accidental, 
and are carefully controlled so as to preserve the integrity of each context. An example 
of multiple contexts is seen in larger hardware devices, such as mainframes, where a 
30 pliu-ality of virtual machines may be defined, each such virtual machine having its own 
execution context. Another example is seen in U.S. Patent No. 5,802,519 in the name of 
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inventor De Jong, which describes the use of multiple execution contexts on a smart 
card. It will be appreciated by those of skill in the art that a computing environmmt 
which provides multiple execution contexts also needs to provide a mechanism for 
associating any given executing code with its corresponding context. 

S Also well known is die notion of a current context. Certain computing 

environments that support multiple contexts will, at any given time, treat one context in 
particular as an active focus of computation. The context can be referred to as the 
"current context." When the current context changes, so that some other context 
becomes the current context, a "context switch" is said to occur. As will be appreciated 

10 by those of skill in the art, these computing environments provide mechanisms for 
keeping track of which context is the current one and for &cilitating context switching. 

In the prior art, in the world of small footprint devices, and particularly in the 
world of smart cards, there was no inter-operation between contexts operating on the 
small footprint devices. Each context operated totally separately and could operate or 

1 S malfimction within its context space without affecting other applications or processes in 
a different context. 

One layer of security protection utilized by the Java™ platform is commonly 
referred to as a sandbox model. Untrusted code is placed into a "sandbox" where it can 
"play" safely without doing any damage to the "real world" or foil Java™ environment. 
20 In such an enviroiunent, Java™ applets don't communicate, but each has its own name 
space. 

Some smart card operating systems dont permit execution contexts to 
commimicate directly, but do permit communications through an operating system, or 
through a server. 

25 The Problems 

A number of problems exist when trying to place computer programs and other 

information on a small footprint device. One of the compelling problems is the 

existence of very limited memory space. This requires often extraordinary efforts to 

provide needed fxmctionality within the memory space, 
30 A second problem associated with small footprint devices is the feict that 

different small footprint device manufacturers can utilize different operating systems. 
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As a result, applications developed for one operating system are not necessarily portable 
to small footprint devices manufactured by a different manufacturer. 

If programs from more than one source of programs (manufacturer or voidor) 
are to be applied to a single small footprint device, security becomes a factor as one 
5 attempts to avoid corruption of existing programs and data when a new program is 
loaded on to the small footprint device. The same concern exists when one wishes to 
prevent a hacker or a malicious person from accessing programs and data. 

It is clear that small footprint devices such as smart cards don*t have the 
resources necessary to implement separate virtual machines. Nevertheless, it is 
10 desirable to maintain strict security between separate execution contexts. 

In the past, security was provided by loading only applications from the same 
soim:e or from a known trusted source onto a smart card or other small footprint device. 

Accordingly, it would be desirable to allow object-oriented interaction between 
selected execution contexts only in safe ways via fast efiicient peer to peer 
IS communications which do not impose undue burdens on the programmer but facilitate 

dynamic loading of applets written at different times by untrusted sources. 

SUMMARY OF THE INVENTION 
The invention is directed to providing a context barrier (sometimes referred to as 
a firewall) for providing separation and isolation of one context Gcom another and to 
20 provide controlled access across the barrier when that is needed. 

In accordance with the invention, two execution contexts, e.g. each containing 
one or more applets, ruiming in the same logical (i.e., virtual or real) machine, protected 
from each other, can share information in a controlled, secure way, using language 
mechanisms, such as object-oriented language mechanisms. Security can be, for 
25 example, object by object. Thus, a method in a first execution context can access a first 

object A in a second execution context, but not a second object B in the second 
execution context on a selective basis. 

In accordance with one exemplary embodiment, an enhanced Java™ Virtual 
Machine (VM) provides certain run-time checks of attempted access across execution 
30 contexts in the VM. Checks can be automatic by the VM or coded by the prograiimier 
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with support fix)m the VM. This can be done using language-level communication 
mechanisms. In this way, one can express object access across execution contexts in the 
same way as other object accesses using the language are made. These run-time checks 
provide a second dimension of defoise/security beyond that which the Java™ language 

5 and platform already provide. 

These mechanisms provide protection against, e.g., security holes due to 
progranfiming bugs (such as declaring a datum "public" (global) when it shouldn't be 
accessible to all contexts). They also allow fine-grain control of sharing (such as 
selection of objects to share and applets to share to). 

10 The invention is also directed to computer program products and carrier waves 

related to the other aspects of the invention. 

The foregoing and other features, aspects and advantages of the present 
invention will become more qjparent from the following detailed description of the 
present invention when taken in conjxmction with the accompanying drawings. 

15 BRIEF DESCRIPTION OF THE DRAWINGS 

The features and advantages of the present invention will be apparent Scorn the 
following description in which: 

Figure 1 is an illustration of a computer equipped with a card acceptance device 
and of a smart card for use with the card acceptance device. 
20 Figure 2 is an illustration of a computer equipped with a card acceptance device 

connected to a network. 

Figure 3 is an exemplary hardware architecture of a small foo^rint device, such 
as a smart card, of the prior art. 

Figure 4 illustrates objects being accessed by principals as done in the prior art. 
25 Figure 5 is an exemplary security model which can be used in explaining the 

various embodiments of the invention. 

Figure 6 is a block diagram showing separation of execution contexts by a 
firewall or context barrier in accordance with one aspect of the invention. 

Figure 7 is a rq)resentation of a software architecture useful in carrying out the 
30 invention. 
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Figure 8 is a flow chart of a security enforcement process implementing a 
firewall in accordance with one aspect of the invention. 

Figure 9 is a block diagram showing object access across a firewall in 
accordance with one aspect of the invention. 
S Figure 10 is a block diagram showing cascaded object access across a firewall. 

Figure 11 is a flow chart of a process for permitting access by a principal in one 
context across a firewall into another context 

Figure 12 is a block diagram illustrating the use of an entry point object to 
permit access across a firewall. 
10 Figure 13 is a block diagram illustrating the use of a global data structure such 

as an array for access across a firewall. 

Figure 14 is a block diagram illustrating the use of a supercontext to permit 
access across a firewall. 

Figure 15 is a block diagram illustrating the use of shareable interface objects to 
IS permit access across a firewall. 

Figure 16 is a flow chart of a security enforcement process pennitting access 
across a firewall 

Figure 17 is the flow chart of Figure 16 showing details of block 1620. 
Figure 18 is a flow chart showing an exemplary implementation of block 1629 
20 of Figure 17. 

NOTATIONS AND NOMENCLATURE 
The detailed descriptions which follow may be presented in ternis of program 
procedures executed on a computer or network of computers. These procedural 
descriptions and representations are the means used by those skilled in the art to most 
25 effectively convey the substance of their work to others skilled in the art. 

A procedure is here, and gaierally, conceived to be a self-consistent sequence of 
steps leading to a desired result. These steps are those requiring physical manipulations 
of physical quantities. Usually, though not necessarily, these quantities take the form of 
electrical or magnetic signals capable of being stored, transferred, combined, compared, 
30 and otherwise manipulated. It proves convenient at times, principally for reasons of 
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common usage, to refer to these signals as bits, values, elements, symbols, characters, 
tenns, numbers, or the like. It should be noted, however, that all of these and similar 
terms are to be associated with the appropriate physical quantities and are merely 
convenient labels applied to these quantities. 

5 Further, the manipulations performed are often referred to in terms, such as 

adding or comparing, which are commonly associated with mental operations performed 
by a human operator. No such capability of a human operator is necessary, or desirable 
in most cases, in any of the operations described herein which form part of the present 
invention; the operations are machine opmtions. Useful machines for performing the 

10 operation of the present invention include general purpose digital computers or other 
computational devices. 

The present invention also relates to apparatus for performing these operations. 
This apparatus may be specially constructed for the required purpose or it may comprise 
a general puipose computer as selectively activated or reconfigured by a computer 

IS program stored in the computer. The procedures presented herein are not inherently 
related to a particular computer or other apparatus. Varioiis general purpose machines 
may be used with programs written in accordance with the teachings herein, or it may 
prove more convenient to constmct more specialized apparatus to perform the required 
method steps. The required structure for a variety of these machines will- appear from 

20 the description given. 

DETAILED DESCRIPTION 
Attached as an Appendix to this specification is an unpublished draft of a 
document entitled JAVA CARD RUNTIME ENVIRONMENT 2.1 SPECIFICATION. 
This draft document, which provides further detailed description of specific 
25 embodiments of the invention, is incorporated in its entirety as an integral part of the 
present specification. 

Although the inventive techniques are described hereinafter in the context of a 
smart card example, the example is merely illustrative and shouldn't limit the scope of 
the invention. 
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Figure 1 is an illustration of a computCT 120 equipped with a card acceptance 
device 110 and a smart card 100 for use with the card acceptance device 110. In 
operation, the smart card 100 is inserted into card acceptance device 110 and power and 
data connections applied through a set of contacts 105 accessible at the surface of the 

5 smart card 100. When the card is inserted, mating contacts from the card acceptance 

device 110 interconnect with the surface contacts 105 to power-up the card and permit 
communications with the onboard processor and memory storage. 

Figure 2 is an illustration of a computer equipped with a card acceptance device, 
' such as 120 in Figure 1, connected to a network 200. Also cormected to a network are a 

10 plurality of other computing devices, such as server 210. It is possible to load data and 
software onto a smart card over the network 200 using card equipped device 120. 
Downloads of this nature can include applets or other programs to be loaded onto a 
smart card as well as digital cash and other information used in accordance with a 
variety of electronic commerce and other applications. The instructions and data used to 

15 control processing elements of the card acceptance device and of the smart card may be 

stored in volatile or non-volatile memory or may be received directly over a 
communications link, e.g., as a carrier wave containing the instructions and/or data. 
Further, for example, the network can be a LAN or a WAN such as the Internet or other 
network. 

20 Figure 3 is an exemplary hardware architecture of a small footprint device, such 

as a smart card, of the prior art. As shown in Figure 3, a processor 300 intercoxmects 
with primary storage 310 which may include read only memory 315 and/or random 
access memory 316. The processor also connects with a secondary storage 320 such as 
EEPROM and with an input/output 330, such as a serial port. One can see the small 

25 footprint devices of this nature can be very simple. 

Figure 4 illustrates objects being accessed by principals as done in the prior art. 
As shown in Figure 4, physical device 400, such as the small footprint device may have 
contained within it one or more processing machines (virtual or physical) which are 
running an execution context 420. The execution context may be, for example, a 

30 context associated with a particular applet. One or more principals 430 (e.g., qjplets or 

applications) in the execution context may seek to access other objects within the 
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execution context. As long as the access occurs within the execution context, the 
accesses will be permitted and eveiything will function normally. 

Figure 5 is an exemplary security model which can be iised in explaining the 
various embodiments of the invention. It is just one of many models which might be 
S utilized but is a convenient model for this purpose. In this model» a principal 
(sometimes called entity) 500 proposes to take an action 510 on an object, such as object 
520. Seciuity checks may be imposed on the principal, on the object, and/or on the 
action proposed to be taken. 

In Figure 5, two types of objects are shown on which action may be taken by a 

10 principal. These include data objects, (e.g. datal and data2 (520, 520')) and entity 530. 
A principal may operate or attempt to operate on any of these objects. 

While data is passive, an entity 530 is active. The diagram line from Principal to 
an active entity is also labeled "action," but this could be a more sophisticated and 
arbitrarily complex action, such as making a function or method call or sending a 

IS message as compared with action on a data object. As with data, a security check 
enforced by the operating system may use the identity of the principal, the identity of the 
entity, and/or the type of action. Furthermore, the entity, being active, can perform its 
own additional.security checks. These can be as arbitrarily complex as one desires, and 
can make use of the identity of the Principal, the identity of the entity itself, the action, 

20 and/or any other information that is available. 

In an object-oriented system (such as the Java Card™ platform) "objects" are 
typically a combination of data and entity. When a Principal tries to access a field of an 
object, this is a data access— a fairly simple action protected by a fairly simple security 
check. When a Principal tries to access a method of an object, this is an entity access, 

25 which can be arbitrarily complex both in action and in security check. 

Figure 6 is a block diagram showing separation of execution contexts by a 
firewall or context barrier in accordance with one aspect of the invention. The physical 
device 400 and the machine 410 correspond to the same items shown in Figure 4. An 
execution context 420 shows one principal 430 attempting to access object 440 within 

30 the context. This access would normally succeed. However, execution context 420 also 

shows a principal 630 attempting to access object 640 of execution context 620, across a 
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context barrier 600. Normally, this access would be prohibited as indicated by the X 
636 where the action 635 crosses the context barrier 600. 

Figure 7 is a representation of a software architecture useful in carrying out the 
invention. This software architecture is shown as a run time environment 700, An 
5 operating system 710 for the small footprint device is commonly used. A virtual 
machine 720, in an exemplary embodiment of the invention, is implemented over the 
operating system. The virtual machine could be a Java Card^ virtual madiine or other 
virtual machine. The c^abilities of a standard virtual machine can be expanded to 
provide the additional fimctionality described herein or the functionality can be provided 

10 as separate modules. The virtual machine 720 may include an interpreter or native 
implementation 730 which provides access to a run time system 740, The run time 
system includes object system 750 for managing the objects of an object oriented 
implementation. Three contexts, 760, 770 and 780, are shown. Each context is 
separated from the other by a context barrier (sometimes referred to as a firewall) 

IS between the execution contexts. Context 760 is, in one specific embodiment, a 
supercontext. That is, context 760 has privileges and capabilities not available to 
subordinate contexts 770 and 780, potentially including privileges to create entry point 
objects or global data structures, and to access objects in subordinate contexts 770 and 
780. 

20 Every object is associated with one particular context. That context is said to 

own each object that is associated with it. The runtime system 740 provides a means for 
imiquely identifying contexts, and a means for specifying and identifying the currently 
executing context. The object system 750 provides a mechanism for associating objects 
with their owning contexts. 

25 For example, the runtime 740 can identify contexts with a unique name, and 

correspondingly the object system 750 can associate objects with that context by 
recording the context's name in the object's header. Information in the object's header 
cannot be accessed by programs written in the object-oriented langiiage, but is only 
available to the virtual machine 720 itself Alternately, the runtime system 740 can 

30 identify contexts by dividing the memory space into separate regions, each for a 
particular context, and correspondingly the object system 750 can associate objects with 
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that context by allocating the object's storage in that context's memory space. 

Figure 8 is a flow chart of a security enforcement process implementing a 
context barrier in accordance with one aspect of the invention. When a principal 
invokes an action on an object (800) a check is made to determine whether the object is 

5 within the context of the principal (810). If it is not, the action is disallowed (840). 

Otherwise, the action is permitted (830). This is the simplest form of context barrier or 
firewall. In one specific embodiment the action is disallowed (840) by throwing a 
security exception if the object is outside of the namespace or the memory space of the 
context requesting access . 

10 Figure 9 is a block diagram showing object access across a firewall in 

accordance with one aspect of the invention. Figure 9 is substantially similar to Figure 
6. However, Figure 9 also shows principal 900 seeking to access object 910 in order to 
perform action 905 on the object 910. According to the invention, rather than having 
the access blocked by the firewall 600, in the way that action 635 is blocked, action 905 

15 is permitted to occur across the firewall through access point 920 so that principal 900 

can perform action 905 on object 910 notwithstanding the fact that the principal and the 
object are in different execution contexts. The mechanisms behind access point 920 are 
described below with reference to Figures 12-18. Note that access point 920 can 
coexist with obstructed accesses such as X 636. Thus access point 920 provides fine- 

20 grain control of sharing (object by object security) across context barrier 600. 

When object access 900 is initiated, the current context setting is context 420. If 
the object 910 is a data object, the action 905 is a simple data access, and no code is 
executed in the second context 620. If the object 910 is an entity object, and the action 
905 results in that object's code being executed, that code is executed in the second 

25 context 620. To execute the code of object 910 in the correct context 620, the virtual 

machine 410 performs a context switch. The context switch changes the current context 
setting to be context 620, and the previous value of the current context setting is stored 
so that it can be restored later. From that point on code will execute in the new current 
context. When the action 905 completes, control is retumed to the point following 

30 access 900. During the return, the virtual machine 410 must restore the value of the 

current context setting to its previous value. 
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Figure 10 is a block diagram showing cascaded object accesses across a 
firewall. Figure 10 shows three execution contexts, 1000, 1010 and 1020. Principal 
1030 in execution context 1 seeks to invoke an action 1035 on object 1050 in execution 
context 2 and does so through access point 1070 in context barrier 600. Object 1050 in 

S execution context 2 has an object access 1040 which seeks to perform an action 1045 on 
the object 1060 in execution context 3. It achieves this by using access point 1080 in 
context barrier 600* separating execution contexts 2 and 3. Object 1050 in execution 
context 2 also has another object access 1090 which invokes an action 1095 on an object 
1099 in the same execution context, that is, in execution context 2. Both actions 1035 

10 and 1045 result in context switches as described in the explanation of Figure 9. But as 
action 1095 does not cross the context barrier, a context switch is not required for its 
execution, and therefore does not occur. 

Figure 11 is a flow chart of a process for permitting access by a principal in one 
context across a firewall into another context. There are essentially three steps to this 

IS process. In execution context 2, an object to be accessed is created and designated as 
shared (1100). In execution context 1, the principal obtains a reference to the object in 
execution context 2 (1110). The principal in execution context 1 then invokes an action 
upon the object designated as shared in context 2 (1120). 

With respect to identifying or designating a created object as shareable as 

20 discussed in item 1100 of Figure 11, this can be done, in accordance with a specific 
embodiment of the invention, by including a shareable attribute in the header of an 
object's representation. Information in an object's header cannot be accessed by 
programs written in the object-oriented language, but is only available to the VM itself. 

Obtaining a reference to an object in another context is a special case of 

25 accessing an object in another context. A mechanism that provides access to an object 
in another context can make other objects available also. For instance, invoking a 
method on an object in another context may return a reference to a second object in a 
different context. An additional mechanism is required to allow an initial reference to 
an object in a different context to be obtained. In a specific embodiment, references to 

30 certain well-known entry point objects can be obtained using a public API. Once the 
initial reference to an object in a different context is obtained, fiirther references can be 
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obtained from diat object, and so on. 

There are four general approaches to obtaining information across a context 
barrier in accordance with the invention. These ^proaches can be utilized individually 
or in combination in order to access an object across a context barrier or to obtain a 

5 refermce of an object to be accessed across a context barrier (1110). These approaches 
are described in Figures 12-18. 

Figure 12 is a block diagram illustrating the use of entry point objects to permit 
access across a context barrier. As shown in Figure 12, some object 1200 in context 
770 (context 1) desires access to information in supercontext 760. In the specific 

10 embodiment, a supercontext 760 contains at least one entry point object 1210. The 
entry point object 1210 can be published as part of a public API, or can be made 
available indirectly through a published API (e.g., in accordance with the mechanisms 
described previously with refermce to Figure 11), so that each context subordinate to 
the supercontext may communicate with the entry point object of the supercontext. (It 

15 will be ^preciated that in other embodiments, entry point objects may be housed by a 
context other than the supercontext.) 

Figure 13 is a block diagram illustrating the use of global data structures to 
permit access across a firewall. In this approach, supercontext 760 creates a global data 
structure such as a global array. In the specific embodiment supercontext 760 is the 

20 only context permitted to create such a global data structure. (It will be appreciated that 
in other embodiments, global data may be housed by a context other than the 
supercontext.) By virtue of its global status, each of the contexts 770 and 780 may read 
and write to the global data structure. Thus, information written into the global data 
structure by one context can be read by another context. For example, this mechanism 

25 can be used to pass binary data or references to objects between contexts. 

Figure 14 is a block diagram illustrating the use of supercontext privileges to 
permit access across a context barrier. In Figure 14, an object in supercontext 760 seeks 
access to context 780 across the context barrier separating the two. Supercontext 760 
can invoke any of the methods of context 780 and can access any of the data contained 

30 within context 780, by virtue of the privileges associated with the supercontext. 
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Figure 15 is a block diagram illustrating the use of shareable interface objects to 
pennit access across a firewalL A shareable interface defines a set of shareable interface 
methods. A shareable interface object is an object that implements at least the set of 
methods defined in a shareable interface. In Figure IS, object 1210 in context 2 (780) 

5 is a shareable interface object. An object access 1200 in another context 770 can invoke 

any of the shareable interface methods on the object 1210 if the principal of the object 
access 1200 is authorized to do so by the object 1210 itself. This authorization is further 
discussed with reference to Figure 18 below. 

It will be q>preciated that a virtual machine consistent with the invention 

10 provides functionality beyond that of earlier virtual machines, such as the virtual 
machine described in the Java™ Virtual Machine Specification . In particular, 
consistently with the invention, the virtual machine provides functionality to implement 
or to facilitate a security enforcement process that permits access across a firewall. This 
process is described next with reference to Figures 16-18. Note that it is applicable to 

IS any approach for providing access across the firewall, including but not limited to &e 
four approaches described with reference to Figures 12-15 above. 

Figure 16 is a flow chart of a security enforcement process permitting access 
across a firewall. When a principal attempts to invoke action on an object 1600, a check 
is made to determine if the object is within the context of the principal (1610). If it is, 

20 (1610- Y), the action is permitted (1630). If it is not, (1610-N), a check is made to see if 
the action by the principal is permitted on the object (1620). If it is, (1620-Y), the action 
is permitted (1630). If it is not, (1620-N), the action is disallowed. In the specific 
embodiment a security exception is thrown (1640). 

Figure 17 is the flow chart of Figure 16 showing further details of block 1620. 

25 If the object is not within the context of the principal (1610-N), a plurality of tests, 1621, 

1622, 1623... 1629 are undertaken to see if the action by the principal is permitted on the 
object. These tests can be done by the virtual machine alone or by the virtual machine 
plus the object, in a virtual machine object oriented implementation. If any of the tests 
results in a pass, the action is permitted (1630). However, if all tests result in a negative 

30 determination (162X— No), the action will be disallowed. In a specific embodiment, a 

security exception will be thrown (1640). These tests relate to the permitted access 
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discussed in conjunction with Figures 12-15. 

Figure 18 is a flow chart showing an exemplary implementation of block 1629 
of Figure 17 for use with access method described in Figure IS. In a test, such as 829 
or 1629, a virtual machine checks if the object is a shared object 1810. If it is not (1810- 
5 No), the test will fail. However, if it is (1810- Yes), the virtual machine will invoke the 

method A on object O (1820). If the method A on object O determines that the principal 
is authorized (1830), the test will be passed (1840) and access permitted. Otherwise, the 
test will fail (1850). This allows the authorization text to be programmed into the code 
of the object itself. 

10 Although the invention has been illustrated with respect to a smart card 

implementation, the invention applies to other devices with a small footprint, not just to 
smart cards. Devices with a small footprint are generally considered to be those that are 
restricted or limited in memory or in computing power or speed. Such small footprint 
devices may include boundary scan devices, field programmable devices, pagers and 

1 5 cellular phones among many others. 

In general, small footprint devices are resource constrained computational 
devices and systems where secure interoperation of execution contexts is a concern. 
Such small devices impose constraints on the implementation of security measures 
because of their limited resources. Because of resource constraints, in a virtual machine 

20 implementation, a single virtual or physical machine must be used as opposed to 

multiple virtual machines. 

The invention may also be applied to devices with larger footprints where the 
characteristics of the invention may prove beneficial. For example, the invention may 
prove advantageous when using servlets if there is object sharing between them. Even 

25 some desktop systems may profitably utilize the techniques of the invention. 

While the Java™ language and platform are suitable for the invention, any 
language or platform having certain characteristics would be well suited for 
implementing the invention. These characteristics include type safety, pointer safety, 
object-oriented, dynamically linked, and virtual-machine based. Not all of these 

30 characteristics need to be present in a particular implementation. In some embodiments, 

languages or platforms lacking one or more of these characteristics may be utilized. A 
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"virtual machine" could be implemented either in bits (virtual machine) or in silicon 
(real/physical machines). 

Although the invention has been illustrated showing object by object security, 
other ^proaches, such as class by class security could be utilized. 
S Although the present invention has been described and illustrated in detail, it is 

clearly understood that the same is by way of illustration and example only and is not to 
be taken by way of limitation, the spirit and scope of the present invention being limited 
only by the terms of the appended claims and their equivalents. 
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Java 'n' Card Runtuie Environment (JCRE) 2. 1 Speciftcation 



Preface 



Java"* Card™ technology combines a portion of the Java programming language with a runtime environment 
optimized for smart cards and related, sroall-manory embedded devices. The goal of Java Card technology is to 
bring many of the benefits of Java software programming to the resource-constrained world of smart cards. 

This document is a specification of the Java Card Runtime Environment (JCRE) 2.1. A vendor of a Java Catdr 
enabled device provides an implementation of the JCRE. A JCRE tmplemeotatioa within die context of this 
specification refers to a vendor's implementatian of the Java Card Virtual Machine (VM)^ the Java Card 
^plication Programming Interfiice (API), or other component, based on the Javsi ^rd technology 
specifications. A Reference Implementation is an implementadoo jmxluced by $un Microsystems, Inc. Applets 
written for die Java Card platform are referred to as Java Card ^lets. 



Who Should Use This Specification? 

This specification is intended to assist JCRE inoplemcnters in creating an implementation, developing a 
specification to extend the Java Card technology specifications, or in creating an extension to the Java Card 
Runtime Environment (JCRE). This specification is also intended fi)r Java Card applet developa;^ who want a 
greater understanding of the Java Card technology specificattoos. 



Before You Read This Specification 

Before reading this guide, you should be familiar with the Java programming language, the Java Card 
technology specifications, and smart card technology. A good resource for beooming &miUar with Java 
technology and Java Card technology is the Sun Microsystems, Inc. website, located at 
http://java.aun.can. 



How This Specification Is Organized 

Chapter 1, ''The Scope and RcsponsfblUtica of the JCRE*" gives an overview of the services required of a 
JCRE iiiq>lementation. 

Chapter 2, "Lifetime of the VIrtnal Machine,** defines the lifetime of die Virtual Machine, 
vi Copyright O Deoember 14, 1 998 Sun Microsystems. Inc. 
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Cliaptcr 3, "Applet Ufctimc," defines the liietime of an applet 

Chapter 4, "ntVasient Objects," provides an overview of tnuisient objects. 

Chapter 5, "^eetion," describes how the JCRE handles applet selection. 

Chapter 6, «*Applet IsoUtion and Object Sharing," describes applet isohuion and dijea sharing. 

Chapter 7, -"IVansactions and Atomicity." provides an overview of atomicity during ttapsactions. 

Chapter 9. « Vlrtoal Machine Topics." describes vimial machine specifics. 
Chapter 10, ''Applet InstaUer," provides an overview of the Applet InsoUer. 

Sf^Tw^on!''''*^ ^"^^ """"^'^ of constants that are not specified m the Jaw, Qi«/ 
Glossary is a list of words and their definitions to assist you in using this book. 



Related Documents and Publications 

d^l^^^Ty^^ documents or producu are made in this manual. You should have the following 

■ Java Card 2 J API Draft 2 Specification, Sun Microsystems, Inc. 

H- Java Card 2,0 l^gi^ge Subset and Viniml Machine Sp^ October 13, 1997, Reinsion LO Final, 

bun Microsystems, Inc. 

■ JiBva Card Applet Developer^s Guide. Sun Microsystems, Inc. 

■ W^f^lKS^t^ 

■ ^fJ^Oase Libraries: An Annotated Reference (Java Series) by Patrick Chan and Rosanna Lee. 
Addjson-Wesley, two volumes, ISBN: 0201310023 and 02013I0031. 

■ ISO 78 1 6 Specification Parts 1 

■ EMV '96 Imegratedarcuit Card Specificatwn for Payment Systems. 
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Java ™ Card ™ Runtime Environment (JCRE) 2. 1 Spectfication 



1. Introduction 



The Java Card Runtime Environment (JCRE) 2. 1 contains the Java Card Virtual Machine (VM), the Java Card 
Applicatton Programming Inter&ce (API) classes (and industry-spedfic extensions), and support services. 

This document, the JCRE 2.1 Specification, specifies the JCRE functionality required by the Java Card 
technology. Any implementation of Java Card technology shall provide this necessary bdiavior and 
enviranment 
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Javn Card ™ Rumime Enviromnent (JCRE) 2.1 Spectftcation 



2. Lifetime of the Java Card Virtual Machine 



'^'^f* ?' i'*" "^Tu When ihe OS proce» it 

tenmnattd. >he Java applicationi and thdr objeeu »». ■■■t'nniHiCTny dgtroyol "wwoprwxau 

Ae fa7«^^rtSi^M^'!l'^'*Sll! ^'"^ (VM) i. the Ufedme of the card. Most of 

the mfonnaooD scored on a card shaU be preserved even when power is removed from the card. Penistmt 

r^'" • ™«« tSV:^ infom^tionTe^^ir^^ 
Se £^tS5 "T" «e used to n:p«sent applicatiba inforaSthi^p^aen,. 

t^Tj^!^^^lj^J^- *J«P»*«-.i"«noved. the VM stops only temponrfy. 
card IS next reset, the VM starts up agam and reeovers its previous object heap from persiamt storage. 

Aside 6om iu penistem nature, the Java Card Virtual Machine U just like the Java Virtual Machine. 

Thecard initializatioii lime is the time after masking, and prior to the time of card personalization and issuance. 

™?rY?r^ Machme. Because the execution lifetime of die Virtual MachinTand AeJC^ 

^iSL^^J^ ^ Acceptance Device « card reader. Card sessions those periodsThen fte card 
is msCTted in d^e CAD. powered up. and exchanging streams of APDUs with die CAD. Tile caid session 
when the card .s removed from die CAD.) Ob|ects that have dti, prcperty are c^lS^S^^ 

The JCRE inq>lementer shall make an olgect persistent when: 

' m ^^^^'J^ " "i}"^- "^^ ""^ ' *««»°" -Pplet object 

The JCRE implementer diall ensure that mstances of class applet ai« persistenL 

* I^^Mt ASi" • "^r^. """^ P«i«=««<*Jeet or in. cla»-. static field. This 

requirement stems from die need to preserve die integrity of die JCRE's intcnal data stnictures. 
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Java ™ Card ^ R-ndme. Environment (JCRE) 2. 1 Specification 



3 . Java Card Applet Lifetime 



For the purposes of this specification, a Java Card applet's lifetime begins at the point that it has been correctly 
loaded into card memory, linked, and otherwise prepared for execution. (For the remainder of this specification, 
applet refers to an applet written fat die Java Card platfonn.) Applets registered with the Applet . register 
metfiod exist for die lifetime of die card The JCRE interactt widi die applet via die applet's public mediods 
Instali, select, deselect, and process. An applet shall implement die stadc install method. If the 
install method is not implemented, die applet's o^ects cannot be created or initialized. A JCRE 
implementation shall call an applet's install, select, deselect, and process methods as described 
below. 

When the applet is installed on die smart card, die static install mediod is called once by the JCRE for each 
applet instance created. The JCRE shall not call the applet's constructor directly. 



3.1 The Method install 

When install is called, no olgects of die applet exist The main task of the install mediod within die applet 
is to aeate an instance of the Applet class, and to register the instance. All other objects diat the applet will 
need during hs lifetime can be created as is feasible. Any other preparations necessary for the applet to be 
selected and accessed by a CAD also can be done as is feasible. The install metfiod obtains inhializadon 
parameters from the contents of the incoming byte array parameter. 

Typically, an applet creates various objects, initializes them with predefined values, sets some internal state 
variables, and calls die Applet . register mediod to specify the AID {itpp\tt IDentifier as defined in ISO 
78 16-5) to be used to select it This installation is considered successful when die call to the 
Applet .register method completes without an exception. The installation is deemed unsuccessful if the 
install method does not call the Applet . register method, cff if an exception is thrown from within the 
install method prior to the Applet . register method being called, or if the Applet . register method 
dirows an exception. If die installation is unsuccessful, die JCRE shall pcrfimn all cleanup when it regains 
controL That is, all persistent objecu shall be renmied to die state diey had prior to calling die install 
mediod. If die installation is successful, die JCRE can mark die applet as available for selection. 
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Java Card ^ Runtime Environxncnt (JCRE) 2.1 Spedficatton 



3.2 The Method select 

Applets remain in a suspended state until they are expUcitly selected. Selection occurs when die JCRE reodves 
a SELECT APDU in which the name data matches the AID of the applet Selection causes an applet to become 
the currently selected applet 

Prior to calling SELECT* the JCRE diall deselect the previously selected applet The JCRE indicates this to die 
applet by invoking the ^iplet*s deselect method. 

The JCRE informs the applet of sdection by faivoldng its select mediod. 

The applet may decline to be selected by returning false from the cafl to die select method or by dirowing 
an exception. If die applet returns true, the acnial SELECT APDU command is supplied to fte applet in die 
subsequent call to its process method, so that die applet can examine d&e APDU contents. The e pptet caa 
process the SELECT APDU command exactly like it processes any odier APDU co mm a nd . It can respond to 
the SELECT APDU with data (see die process mediod for detaib). or it can flag-orara by dirowing an 
isOException widi die appropriate SW (returned status word). Tlic SW and opdonal response data are 
returned to the CAD. 

The Applet . selectlngwlet mediod shall return true when called during the select method. Hie 
Applet . selectlngApplec method will continue to rettan true during the subsequent process mediod, 
which is called to process die SELECT APDU conunand 

If die applet declines to be selected, die JCRE will rewm an APDU response status word of 

ISO . SM_APPLET_SELECr_FAiLED to die CAD. Upon selection ftilure. die JCRE state is set to fadicate diat 

no i^Jplet is selected. 

After successfiil selection, all subsequent APDUs are delivered to die currendy selected applet via die process 
method. 



3.3 The Method process 

All APDUs arc received by the JCRE, which passes an instance of the APDU dass to die process mediod of 
the currently selected applet 

Note - A SELECT APDU might cause a change in die currendy selected applet prior to the call to die 
process method. 

On n ormal return, the JCRE automatical ly appends 0x9000 as die compledoo response S W to any data already 
sent by the apjriet 

At any time during process, die applet may dirow an XSOBxception with an appropriate SW, in which case 
the JCRE catches die cxcepdoo and remms the SW to die CAD. 

If any odier excqstion is dirown during process, die JCRE catches die exception and rettims die stams word 
ISO? 8 16 . SHJONKNOmi to the CAD. 
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3.4 



The Method deselect 




Cleanup operations that may be required m order to allow some other applet to execute. 

The Applet . select ingApplet method shall return 61se when called during the deselect method. 
Exccpuons thrown by the deselect method are caught by the JCRE, but the applet is if^ Hrff fd 



3,5 Power Loss and Reset 

Power lo» occurs when the card is withdrawn from the CAD or if there is some other mechanical or electrical 
feilure. When power is respited to the caid and on Card Reset (wann or cold) the JCRE shall ensure that 

• Transient data is reset to the defiEuilt value. 

• The tnnsactian in progress. If any, when power was lost (or reset occurred) is aborted. 

• The applet that was selected when power was lost (or reset occurred) becomes impliciUy deselected. (In 
this case the deselect method is not called.) 

• If the JCRE implanents dcfeult applet selection (see paragraph 5. 1 X the de&ult applet is selected as the 
currently selected applet, and that the de£uih an>let's select method is called. Otherwise, the JCRE sets 
Its state to mdicate that no applet is selected. 
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4. Transient Objects 



Applets sometimes require obiects that contain temporaiy (transient) data that need not be persistent across 
CAD sessions. Java Card does not support the Java keyword tranaient. However. Java Card tedmology 
provides methods to create transient arrays with primitive components or references to object. 

The tmn ^Iransient object** is a misnomer. It can be incorrectly interpreted to mean that the object itself is 
transient However, only the contents of the fields of the object (except for the length field) have a transient 
nature. As with any other object in the Java programming language, transient objects within the Java Card 
platform exist as long as they are referenced from: 

• The stack 

• Local variables 

• A class static field 

• A field in another existing objttx 

A transient object within the Java Card platform has the following required behavior. 

• The fields of a transient object shall be cleared to the field's de&ult value (zero, £Use, or null) at the 
occurrence of certain events (see below). 

• For security reasons, the fields of a transient object shall never be stored in a **persistent memory 
technology." Using current smart card technology as an example, the contents of transient objects can be 
stored in RAM, but never in EEPROM The purpose of this requirement is to allow transient objects to be 
used to store session keys. 

• Wrhes to the fields of a transient object shall not have a performance penalty. (Using cuneat smart card 
tedmology as an example, die contents of transient objects can be stored in RAM, while the contents of 
non-transient objects can be stored in EEPROM. Typically, RAM technology has a much ftster write cycle 
time than EEPROM.) 

• Writes to the fields of a transient ol:rject shall not be affected by 'transactions." That is. an 
abortTranaaccion will never cause a field in a transient object to be restored to a previous vahie. 

This behavior make transient objects ideal for snmll amounts of t em p or ar y applet data that is fiequently 
modified, but that need not be preserved across CAD or select sessions. 
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4, 1 Events That Clear Transient Objects 

Persistent objects are used for maintaining states that shall be preserved across card resets. When a transient 
object is created, one of two events are specified that cause its fields to be cleared. CLEAR.ON_|t£SET 
transient objects are used for maintaining states that shall be preserved across applet selections, but not across 
card resets. CZJEAR^ON^DESELECT transient objects are used for maintaining states that must be preserved 
w^ile an applet is selected, but not across applet selections or card resets. 

Details of the two clear events are as follows: 



• CLEAR^ON.RESET — the object's fields are deaied when the card is reset. When a card is powered on. 
this also causes a card reset 



Note - It is not necessary to dear the fields of transient objects before power is removed from a card 
However, it is necessary to guarantee that the previous contents of such fields cannot be recovered once 
power is lost. 

• CLEAR^OhLDESELECr— 4he object's fields are cleared whenever any ^\et is deselected. Because a 
card reset implicitly deselects the currently selected applet, the fields of CLEAIL.ONJ3ESELECT objects 
are also deared by the same eventt spedfied for CL£AR^ON_|tESET. 

The currently selected applet is expliddy desdected (its deselect method is called) only when a SELECT 
command is proc e ssed. The currently selected applet is deselected and then the fidds of all 
CLEAR^OHJDESELECT transient obfects are deared regardless of whedicr the SELECT command: 

• Fails to sdeet an applet. 

• Sdects a different an>let 
s Reselects the same applet 
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5. Selection 



Cards receive requests for service from the CAD in the form of APDUs. The SELECT APDU is used by the 
JCRE to designate a currently selected applet. Once selected, an applet receives all subsequent APDUs until the 
applet becomes deselected. 

There is no currently selected applet when either of the following occurs: 

• The card is reset and no applet has been pre-designated as the d^asdt applet, 

• A SELECT command &ils when attempting to select an applet. 



5. 1 The Default Applet 

Normally; applets become selected only via a successful SELECT command. However, some smart nrd CAD 
qiplications require that there be a de&ult applet that is implicitly selected after every card reset. The behavior 

is: 

1. After card reset (or power on, which is a form of reset) the X3t£ performs its initializations and checks 
to see if its internal state indicates that a particular applet is the default applet If so. the JCRE makes this 
applet the currently selected applet, and the inlet's select method is caUed. If the applet's select 
method throws an exception or returns false, then the JCRE seta its state to indicate that no applet is 
selected. (The applet*s process method is not called during de&ult qsplet selection because there is no 
SELECT APDU.) When a default q)plet is selected at card reset, it diaU not require itt process 
method to be called. 

2. . The JCRE ensures that the ATR has been sent and the card is now ready to accept APDU conunands. 

If a de&ult applet was successfully selected, then APDU commands can be sent directly to this applet If a 
de&ult applet was not selected, then only SELECT commands can be processed. 

The mechanism for specifying a default applet is not defined in the Java Card API 2. 1. It is a JCRE 
implementation detail and is left to the individual JCRE implementers. 
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5.2 SELECT Command Processing 

The SELECT APDU cammand is used to select an applet Its behavior is: 

1 . The SELECT APDU is always processed by the JCR£ regardless of which* if any, applet is active. 

2. The JCRE searches itt internal table for a matching AID. The JCRE shall support selecting an applet where 
the full AID is present in the SELECT command. 

JCRE implementers are free to enhance tfieir JCRE to support other selection criterion. An exanqile of this 
is selection via partial AID match as q^edfied in ISO 7816-4. The specific requirements are as follows: 

Note - An asterisk indicates binary bit numbering as in IS07816. Most significant bit *> b8. Least sisnificant 
bit-bl. *^ 



a) Applet SELECT command uses CLA-OxOO, INS-0xA4. 

b) Applet SELECT command uses "Selection by DF name". Therefbre» P 1-0x04. 

c) Any other value of PI implies that is not an applet select The APDU is processed by the cuncntly 
selected applet 

d) JCRE shaU support exact DF name (AID) selection Le P2-%b0000 xxOO. (b4,b3* are donY care). 

e) All other partial DF name SELECT options (b2,bl *) are JCRE implementatian dependent 

0 All file control Information option codes 0>4.b3^) shall be supported by the JCRE and interpreted 
and processed by the applet 

3. If no AID match is found: 

a. If there is no currently selected applet the JCRE responds to the SELECT command with status code 
0x6999 (SW^PLET_SELECTJf AILED). 

b. Otherwise, ihe SELECT command is forwarded to the currently selected applet's pracess method. 
A context switch into the applet's context occurs at this point (The applet context is defined in 
paragraph 6. 1. 1.) Appleu may use the SELECT APDU command Ibr their own internal SELECT 
processing. 

4. If a matching AID is found, die JCRE prepares to select the new applet If there is an currently selected 
applet it is deselected via a call to its deselect method. A context switch into the deselected applet's 
context occurs at this point The JCRE context is restored upon exit from desele ct. 

5. The JCRE sets the new currently selected applet The new applet is selected via a call to its select 
method, and a context switch into die new applet's context occurs. 

a. If the applet's select method throws an excqnion or returns false, then JCRE state is set so diat no 
applet is selected. The JCRE responds to the SELECT conmund with status code 0x6999 
(SW.APPLET.SELECT.FAILED). 

b. Ihe new currently selected applet's process method is dien called widi die SELECT APDU as an 
input parameter. A context switch into the applet's context occurs. 

Notes - 
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If there is no matching AID. the SELECT command is fonwded to the currently seleaed applet (if aSwfo? 

processing as a luxmal applet APDU command. w oiipi« ^ii any; lor 

K Acre is a matching AID and the SELECT command tails, the JCRE alwa)« enters the state where oo i^piei is 

If die matdimg AID is the ome as the curremly selected <4>plet. the JCRE still goes through the process of 
sd^"* "^"^^ Reselcction could foil, leaving die »d in a stt^ wh« no applet is 



5.3 Non-SELECT Command Processing 



Wi« a non-SELECT APDU is received and there is no cunently selected applet, the JCRE shall respond to the 
APDU With status code 0x6999 (SW_APPLET_SELECT.FAILED). rcspwia lo ine 

When a non-SELECT APDU is received and there is a curremly selected applet, die JCRE invokes the 
process m^hodof the currently selected applet passing die APDU as a parameter. TTiis causes a context 
sjvitch from the JOIE context into die currently selected applet's context. When die process mediod exits, 
die VT^ switches back to die JCRE context The JCRE «^ 
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6. Applet Isolation and Object Sharing 



Any implementation of the JCRE shall support isolation of contexts and applets. Isolation means that one applet 
can not access the fields or objects of an applet in another context unless the other applet explicitly provides an 
inter&ce for access. The JCRE mechanisms for applet isolation and object sharing are detailed in the sections 
below. 



The applet firewali within Java Card technology is nmtime-enforced protection and is sepaiate fiom the Java 
technology protections. The Java language protections still apply to Java Card applets. The Java language 
eiunires that strong typing and protection attributes are enforced. 

Applet firewalls are always enforced in the Java Card VM. They allow the VM to automatically perfonn 
additional security checks at runtime. 



Firewalls essentially partition the Java Card platfonn*s object system into separate protected object spaces 
called contexts. The firewall is the boundary between one context and another. The JCRE shall allocate and 
manage an applet context for each ^>plet that is installed on the card. (But see paragraph 6. 1 . 1.2 below for a 
discussion of group contexts.) 

In addition, the JCRE maintains its own JCRE context. This context is much like an applet context, but it has 
special system privileges so that it can p afmin operations that are denied to applet contexts. 

At any point in time, there is only one acfive context within the VM. (This is called the curremfy active 
context.) All bytecodes that access objects are checked at runtime against the currently active context in order to 
determine if the access is allowed. A java . Xang . SecurityException is thrown when an access is 
disallowed. 

When certain well-defined conditions are met during the execution of invoke-type bytecodes as described in 
paragraph 6.2.8. the VM performs a contctt switch. The previous context is pushed on an internal VM stack, a 
new context becomes the currently active context, and the invoked method executes in this new context Upon 
exit from that method the VM performs a restoring context switch. The original context (of the caller of the 
method) is popped fiom the stack and is restored as the cunently active context. Context switches can be 
nested. The maximum dqith depends on the amount of VM stack space available. 



6.1 



Applet Firewall 



6. 1 . 1 Contexts and Context Switching 
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Most method invocations in Java Card technology do not cause a context switch. Context swHches only occur 
t?S\ ^ catam methods, as well as during exception exits from those methods (si 



During a context-switching method invocation, in additional piece of data, indicating the cmraitly active 
context, is pushed onto the return stack. This context is restored when the method is exited. 

Further details of contexts and context switching are provided in later sections of this chapter. 
6.1.1.1 Group Contexts 

Usually, each instance of a Java Card applet defines a separate context. But with Java Card 2. 1 technology, the 
concept of group context is introduced. If more than one applet is contained in a single Java package, ihey share 
the same context Additionally, all instances of the same applet dass share the same context In other words, 
there is no firewall between two applet instances in a group context. 

The discussion of contexts and context switching above in section 6. 1. 1 assumes that each applet insuuice is 
asMciatcd with a separate context In Java Card 2, 1 technology, contexts are compared to enforce the firewall, 
and the mstance AID is pushed onto the Aack. Additionally, this happens not only when the context switches, 
but also when control switches from an o^ect owned by one applet instance to an oUect owned by another 
mstance within the same package. 



6. 1.2 Object Ownership 

When a new object is created, it is associated with die currently active context. But the object is o\med by the 
applet instance within the currently active context when the object is instantiated. An object is owned by an 
^iplet instance, or by the JCRE. 



6. 1 ,3 Object Access 

In general, an object can only be accessed by its owning context, that is, when the owning context is the 
currently active context The firewall prevents an object from being accessed by another applet in a different 
context 

In implementation tmns, each time an object is accessed, the olgect's owner context is ccanpared to the 
curmtty active context. If these do not match, the access is not performed and a SeeurityExeeption is 
thrown. 

An object is accessed when one of die following bytccodes is eteeuted using the obrject's reference: 

getfleld. putfield. invokevirtual, invokeinterface. 
athrow, <T>«load, <T>a8tore, axraylength, eheckcaat, instanceof 
<T> refers to the various types of array bytccodes. such as baload, sastore, etc. 

This list includes any special or optimized forms of these bytccodes implemented in die Java Card VM, such as 
getCield.b, sgetf ield_s_thi8,etc. 



6 . 1 .4 Firewall Protection 

The Java Card firewall provides protcaion against the most frequently anticipated security concern; developer 
mistakes and design oversightt that might allow sensitive data to be "leaked" to anodier applet An applet may 
be able to obtain an object reference from a publicly accessible location, but if die object is owned by a 
ditxerem applet, the firewall ensures security. 
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TTic firewall also provides protection against incorrect code. If incorrect code is loaded onto a card, the firewaU 
stiU protects objects from being accessed by this code. 

The Java Card API 2. 1 specifies the basic minimum protection requirements of contexts and firewalls because 
these features shall be supported in ways that are not transparent to the applet developer. Developers «haU be 
aware of the behavior of objects, APIs, and exceptions related to the firewall. 

JCRE implemeniers are free to implement additional security mechanisms beyond diose of the applet firewall, 
aslong as these mechanisms are transparent to applets and do not change the externally visible operation of the 



6. 1 .5 Static Fields and Methods 

It should also be noted that classes are not owned by contexts. There is no nmtime context check that can be 
performed when a class static field is accessed. Neither is there a context switch when a static method is 
invidced. (Similarly, invokespeeial causes no context switch.) 

Public static fields and public static methods are accessible fi^ora any context: static methods execute in the 
same context as their caller. 

Objects referenced in static fields are just regular objects. They are owned by whomever created diem and 
standard firewall access rules apply. If it is necessary to share them across mukiple applet contexts, then these 
objects need to be Shareable Intetface Objects (SIOs). (See paragraph 6.2.4 below.) 

Of course, the conventional Java technology protections are still enforced for static fields and methods. In 
addition, when applets are installed, the Installer verifies that each attempt to link to an external static field or 
method is permitted. Installation and specifics about linkage are beyond the scope of this specification. 

6. 1 .5 . 1 Optional static access checks 

The JCRE may perform optional runtime checks that are redundant with the constraints enforced by a verifier. 
A Java Card VM may detect when code violates fundamental language restrictions, such as invoking a private 
method in another class, and report or otherwise address the violation. 



6.2 Object Access Across Contexts 

To enable appleu to interact with each other and with the JCRE, some well-defined yet secure mechanisms are 
provided so one oontext can access an object belonging to another comexL 

These mechanisms are provided in the Java Card API 2. 1 and are '<'*'nmfd in the following sections: 

• JCRE Entry Point Objecu 

• Global Anays 

• JCRE Privileges 

• Shareable Interfaces 
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6.2. 1 JCRE Entry Point Objects 

Secure computer systems shall have a way for non-privileged user processes (that are restricted to a subset of 
resources) to request system services perfonned by privileged **8ystem** routines. 

In the Java Card API 2. U this is accomplished using yCft£ Entry Point Objects. These are objects owned by the 
JCRE context, but they have been flagged as containing entiy point methods. 

The firewall protects these objects from access by applets. The entry point designation allows the methods of 
these objects to be invoked from any context. When that occurs, a context switch to the Jj:R£ context is 
performed. These methods are the gateways through which applets request privileged JCRE system services. 

There are two categories of JCRE Entry Point Objects : 

• Temporary JCRE Entry Point Objects 

Like all JCRE Entry Point Objects, methods of temporary JCRE Entry Point Objects can be invoked from 
any applet context However, references to these objects cannot be storied in class variables, instance 
variables or array components. The JCRE detecU and restricts attempts to store references to these objects 
as part of the firewall functionality to prevent unauthorized re-use. 

The APDU object and all JCRE owned exception objecu are examples of temporary JCRE Entry Point 
Objects. 

• Permanent JCRE Entry Point ObjecU 

Like all JCRE Entry Point Objects, methods of permanent JCRE Entry Point Objects can be invc^ed from 
any applet context. Additionally, references to these objecU can be stored and freely re-used. 

JCRE owned AID instances are examples of permanent JCRE Entry Point Objects. 

The JCRE is re^Kmsible for: 

• Detecmintng what privileged services are provided to applets. 

• Defining classes containing the entry point methods for diose services. 

• Creating one or more object instances of those classes. 

• Designating those instances as JCRE Entry Pdnt Objects. 

• Designating JCRE Entry Point ObjecU as tcmpocary or permaneoL 

• Making references to those objectt available to applets as needed. 

Note - Only the methods of these objects are accessible through the firewall. The fields of these objectt are still 
protected by the firewall and can only be accessed by the JCRE context 

Only the JCRE itself can designate Entry Pdnt Directs and wbedicr they are temporary or permanent JCRE 
tmptonentera are responsible for implementing the mechanism by which JCRE Entry Pmnt Otyectt are 
designated and how they become te mporary or permanent 

6.2.2 Global Arrays 

The global nature of some objectt requires that they be accessible from any applet context The firewall would 
ordinarily prevent diese objectt from being used in a flexible manner. The Java Card VM allows an object to be 
designated as gloM, 

All global arrays are temporary global array objectt. These objectt are owned by the JCRE context, but can be 
accessed fixxn any applet context However, references to these otgectt cannot be stared m class variables. 
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objects as part ofihelirewaJlluneticmlity to prevemtnauthorired re-use. •««kbs lo nieie 



f™!?^^^' **' ^ desienated as global and only the JCRE itself can designate giobal 

anays. Because applets Mimot create diem, tw API medtods are defined JCRE impleme^^rrl^ible 
for implementing die mechanism by which global anays are designated. «e responsible 

ApSut^^^^^S^ of this spedficsti*.. d,e only global ainy. required in die Java Cart API 2. 1 are d« 
APDUbufferanddiebyteanaymputparameter(bArray)toaieapplet*inatallmediod. 

i!^?." ofits Slobal status, die API specifies that die APDU buffer is cleared to zeroes whSS;;^1S~" 

acc^ inm a Aar^mtetftce object context and is suitable fi>r passing data across nplet eowotts ThV 
applet « responsible lor crot ecting secret data duit troy be accessed fiom d« APPUbSfar 

6.2.3 JCRE Privileges 

obiect on tbe ord. For exaniple. assume duit object X is owned by applet A. Normallv onlv cont«tt A ^ 

access die field. ««lmed«ds of X. But die JCRE context is allo,iedlS invoke^f .^^^ of 

such an mvocatum. a context switch occ ur, firom die JCRE context to the applet ^t«l dST^ X ' * 

Ntrte - The JCRE on access bodt methods uAfieUs of X Mediod access is die mechanism by which die 

JCRE enters an applet context Abhougb dte JCRE could invoke any iftediod diro«SJ«^Mdl h *aH only 



cootettisdie -root context and is always eidier die cuirenUy active context or dwboocm context saved on dte 

6.2.4 Shareable Interfaces 

Sl^^fi;!^'^r.\"^'?^"*''''*<=«**'^'2.1 tocnableappletintenKtion. A shareable 
mtefcce defina a set of shaied mterfiux mediods. THese interfece mediods can be invidced fromme luwlet 
context even if die object implemendng diem is owned by anodier applet contoc" ^ 

'«V'«»««»«g a shareable interfcce is called a Shar^ble 

To the owning context^ die SIO is a normal object whose fields and mediods can be accessed. To any odier 
comwt, die SIO B an mstance of the shareable interfece. and cnly die mi^ho^d^^hX iiSble 
mterfece are accessible. All odier fields and mediods of die SIO Lt prot«^by*?&e^l 

Shareable faittr&ces provide a secure mechanism for inter-applet communication, as follows: 

' ■ taU^ft^ ^tSilS^.""** t?'^ "^'^ ^ ' SL A shareable 

S!^.t^Si^cr^ 3«vacard.£raiaework.Share«ble. The mediods defined in d>e 
shareable mter&ce. SI. represem die service, diat applet A mdce. aceemble to odier applets. 

^' ^!,t^n^Tr'^""f '^J^ irtpJonent. die shareable interfiu»SI. C implements die mediods 
Only the mediods defined m SI are accessible to odier applets. »ppi« nrewaii. 
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3 . Applet A creates an object instance O of class C. O belongs to applet A, and the firewall allows A to access 
any of the fields and methods of O. 

4. To ecces applet A*s c^ject O. applet B creates an object reference SIO of type SI. 

5. Applet B invokes a special method (JCSystem . getAppl etShareable Inter faceobject, described in 
paragraph 6.2.7.2) to request a diared interface object reference from applet A. 

6. Applet A receives the request and the AID of the requester (B) via 

Applet .get Shareable Znt erf aceObject. and detenntnes whether or not it will share object O with 
applet B. 

7. !f applet A a^es to share with applet B, A responds to the request with a reference to O. This reference is 
cast to type Shareable so that none of the fields or methods of O are visible. 

8. Applet B receives the object reference from applet A, casts it to type SI, and stores it in ctojeoX reference 
SIO. Even though SIO actually refers to A's object O. SIO is of type SI. Only the shareable interface 
methods defined in SI are visible to B. The firewall prevents the otficr fields and methods of O from being 
accessed by B. 

9. Applet B can request service from applet A by invoking one of the shareable tntcr&ce methods of SIO. 
During die invocation the Java Card VM per for ms a context switch. The original cuzicntly active context 
(B> is saved on a stack and the context of the owner (A) of the actual object (O) becomes the new currently 
active context. A*s implementation of the shareable interface method (SI method) executes in A*s context 

1 0. The SI method can find out the AID of its client (B) via the JCSystem .getPreviousContextAZD 
method This is de sc ribed in paragraph 6.2.5. The method determines whether or not it will perform Ae 
service for applet B. 

1 1. Because of the context switch, the firewall allows the SI method to access all the fields and methods of 
object O and any other otject owned by A. At the same time, the firewall prevents the method from 
accessing non-^ared otjects owned by B. 

12. The SI method can access die parameters passed by B and can provide a return vahie to B. 

13. During the return, the Java Card VM performs a restoring context switch. The original currently active 
context (B) is p<^ped from the stack, and again becomes the current context. 

14. Because of the context switch, the firewall again allows B to access any of its objects and prevents B from 
accessing non-shared objects owned by A. 

6.2.5 Determining the Previous Context 

When-an applet calls JCSystem . getPreviousContextAlD, the JCRE shall return the instance AID of the 
^iplet instance active at the time of the last context switch. 

6.2.5.1 The JCRE Context 

The JCRE context does not have an AID. If an applet calls the getPreviousContextAlD mediod when the 
applet context was entered directly from the JCRE context, this method returns null . 

If the applet calls getPreviousContextAZO from a method that maybe a c cessed either from within the 
applet hself or when accessed via a shareable interftoe from an extonal applet, it shall check for null return 
before performing caller AID authentication. 
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6.2.6 Shareable Interface Details 

A shareable inter&ce is simply one that extends (cither directly or indirectly) the tagging interfece 
javacftrd . frataawrk. Shareable. This Shareable interfece is similar in concept to the Remoce interfece 
used by the RMI fecility, in which calls to the interfece methods take place across a local/remote boun<fery. 

6.2.6. i The Java Card Shareable Interface 

Inierfeccs extending the Shareable tagging interfece have this special property, calls to the interfece 
methods take place across Java Card's aiglet firewall boundary via a context switch. 

Hie Shareable interface serves to identify all shared objects. Any object that needs to be shared through the 
applet firewall shall directly or indirectly implement this interfece. Only those methods specified in a shareable 
interfece are availabi e through the firewall 

Implementation classes can implemmt any number of shareable tnterfeoes and can extend odier sharr^ M f 
implementation classes. 

Like any Java platform intaiace, a shareable interfece simply defines a set of service methods. A service 
provider class declares tfiat it "implements" the shareable interfiicc and provides implcmentatiais for each of 
the service methods of the interfece. A service client class accesses the services by obtaining an object 
reference, casting it to the diareable interfece type if necessary, and invoking the service methods of the 
interfece. 

Hie shareable interfeoes within the Java Card technology shaU have the following properties: 

• When a method in a shareable interfece is invoked, a context switch occurs to the context of the object's 
owner. 

• When the method exits, the context of the caller is restored. 

• Exception handling is enhanced so that the currently active context is correctly restored during the stack 
frame unwinding that occurs as an excepdon is thrown. 



6.2.7 Obtaining Shareable Interface Objects 

inter-applet communication is accomplished when a client applet invokes a shareable interfece method of a SIO 
belonging to a server applet In order for this to work, there must be a way for the client applet to obtain tfie SIO. 
from the server applet in the first place. The JCRE provides a mechanism to make this possible. The Applet 
class and the jcsyseem class provide methods to enable a client to request services from the server. 

6.2.7.1 TheMethod Applet .getShareablelnterfaceObject 

This method is implemented by the server applet instance. It shall be called by the JCRE to mediate between a 
client applet tfiat requests to use an object belonging to another applet, and the server applet that makes its 
objects available for sharing. 

The defeult behavior shall return null, which indicates that an applet does not participate in inter-applet 
communication. 

A server applet that is intended to be invoked from another applet needs to override this method. This method 
should examine the clientAlD and the parameter. If the clientAlD is not one of the expected AIDs, the 
method should return null. Similarly, if the parameter is not recognized or if it is not allowed for the 
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cl ienuaD» then the method also should return null. Otherwise, the applet should return an SIO of the 
shareable tntcrSioe type that the client has requested. 

The server applet need not respond with the same SIO to all clients. The server can support multiple types of 
shared interftces for different purposes and use client AID and paramecer to determine which kind of SIO 
to return to the client. 

6.2.7.2 The Method JCSystem.getAppletShareablelnterfaceObject: 

Ihe JCSyetem class contains fte method getAppletShareableinterf aceObject. which is invoked by a 
client applet to communicate with a server applet 

The JCRE shall implement this method to behave as follows: 

1 . The JCRE searches its internal applet table for one with aervarAlo. If not found, null is returned. 

2. The JCRE invokes this applet's getSbareablelnterCaceObject method, passmgthe cllentAIO of 
the caller and the paraneter. 

3. A context switch occurs to the server applet, and its implementation of 9e tshareafarie mterf aceOb j act 
proceeds as described in the previous section. The server applet returns a SIO (or null). 

4. gecAppletShareableZnterfaceObject returns the same SIO (or null) to its caller. 

For enhanced security, the implementation dull make it impossible for the client to tell which of the following 
conditions caused a null value to be returned: 

• The serverAZD was not found. 

• The server applet does not participate in inter-applet communication. 

• The server applet does not recognize the cl iencAiD or the parameter. 

• The server applet won't communicate with this client 

• The server applet won*t communicate wiA this client as specified by the panuneter. 



6.2.8 Class and Object Access Behavior 

A static class field is aoceatd when one of the following Java byteoodes is executed: 
getatatic, putatatic 

An object is accessed when one of the following Java bytecodes is executed using the object's re feren ce: 

geteield« piitfield, invokevirtual , invokeinterface« attarow, 
<T>aload, cT>afitore, arraylengtb, cbeckcaat* inatanceof 

<T> refers to the various types of array bytecodes, such as baload, aascore, etc. 

This list also includes any special or optimized fonns of these byteoodes that may be implemented in the Java 
Card VM, such as getf ield_b, 8geteield_8_thi8, etc 

Prior to performing the work of the bytecode as specified by Che Java VM, the Java Card VM will p q f uim an 
access check on (he referenced object. If access is denied, then a SecurityException is thrown. 

The access checks performed by die Java Card VM depend on the type and owner of the referenced object, the 
bytecode, and the currently active oontext They are described in die following sections. 
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6.2. 8. 1 Accessing Static Class Fields 

Bytecodes: 

getstatic. put static 

■ If the JCRE is the currently active context, dicn access is allowed. 

■ Otherwise, if the byteoode is putstatic and the field being stared is a reference type and the reference 
being stared is a rdferenoe to a temporary JCRE Entry Point Object or a global array then access is denied. 

■ Otherwise, access is allowed. 



6.2.8.2 Accessing Array Objects 

Bytecodes: 

<T>aload, <T>aBtore, array length, checkcast, irvstanceof 

■ If the JCRE is the currently active context, then access is allowed 

■ Odierwise. if the bytecode is aaatore and the component being stoied is a relierence type and the 
reference being stored is a reference to a temporary JCRE Entry Point Olgect or a global array then access 
is denied. 

■ Otherwise, if the array is owned by the currently active context, then access is allowed. 

■ Otherwise, if the array is designated global, then access is allowed. 

■ Otherwise, access is denied. 

6.2.8.3 Accessing Class Instance Object Fields 

Bytecodes: 

getfield* putfield 

■ If the JCRE is the currently active context, then access is allowed. 

■ Otherwise, if the bytecode is put f ield and the field being stored is a reference type and the reference 
being stored is a reference to a temporary JCRE Entry. Point Object or a global array then access is denied. 

■ Otherwise if the abject is owned by the currently active context, then access is allowed. 

■ Otherwise, access is denied 



6.2.8.4 Accessing Class Instance Object Methods 

Bytecodes: 
invoXevirtual 

■ If the object is owned by the currently active context, then access is allowed. Context is switched to the 
object owner's context. 

■ Otherwise, if the object is designated a JCRE Entry Point Ol^ect, then access is allowed. Context is 
switched to the object owner*s context (shall be JCRE). 
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■ Otherwise, if JCRE is the currently active ccnStcxt, then access is allowed. Contexi is switched to the object 
owna*s context. 

■ Otherwise, access is denied. 

6.2.8.5 Accessing Standard Interface Methods 

Bytecodes: 
invokelacerface 

■ If the object is owned by the cuncntly active context, then access is allowed. 

■ Otherwise, if die JCRE is the currendy acdve context, Oien access is allowed. Context is switched to the 
object owner's context 

■ Otherwise, access is denied. 

6.2.8.6 Accessing Shareable Interface Methods 
Bytecodes: 

invokeinfeerface 

■ If the object is owned by the currently active context, then access is al lowed. 

■ Otherwise, if the object's class implements a Shareable interface, and if die interface being invoked 
extends die shareable inter&ce, dien access is allowed. Context is switched to die object owner's 
context 

■ Odienvise, if die JCRE is die cutTcntly active context, dien access is allowed. Context is switched to die 
otject owner's context 

■ Odierwise, access is denied. 
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6.2.8.7 Throwing Exception Objects 
Bytecodes: 

athrow 

■ If the object is owned by the currently active context, then access is allowed. 

■ Otherwise, if the object is designated a JCRE Entry Point Object, then access is allowed. 

■ Otherwise, if the JCRE is the currently active context, then access is allowed. 

■ Otherwise, access is dented. 

6.2.8.8 Accessing Class Instance Objects 

Bytecodes: 

checkcaat, Instanceof 

■ If the object is owned by the currently active context, then access is allowed. 

■ Otherwise, i f JCRE is the currently active context, then access is allowed. 

■ Otherwise, if the object is designated a JCRE Entry Point Object, then access is allowed. 

■ Otherwise, if the JCRE is the currently active context, then access is allowed. 

■ Otherwise, access is denied. 

6.2.8.9 Accessing Standard Interfaces 

Bytecodes: 

checkcast. instanceof 

■ If the object is owned by the currently active context, then access is allowed. 

■ Otherwise, if the JCRE is the currently active context, then access is allowed. 

■ Otherwise, access is denied. 

6.2.8.10 Accessing Shareable Interfaces 

Bytecodes: 

checlccast, inatanceoC 

■ If the object is owned by the currently active context, then access is allowed. 

■ Otherwise, if the object's class implements a Shareable inierfecc, and if the object is being cast into 
(checlccast) or is an instance of (instanceoO an interface that extends the shareable mter&ce, then access 
is allowed. 

■ Otherwise, if the JCRE is the currently active context, then access is allowed. 

■ Otherwise, access is denied. 
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6.3 Transient Objects and Applet contexts 

Transient (Ejects of CLEAR._ON_R£SET type behave like persistent ol^ects in that they can be accessed only 
when the currently active applet context is the same as the owner of ttie object (the cmrentty active applet 
context at the time when the oigect was created^ 

Transient objects of CLEAR_ON_DESEL£CT type can only be created or accessed when the currently active 
applet context is the currently selected applet context. If any of the makeTransient factory methods is 
called to create a CLEAR_ON_DESELECT type transient <4>ject when the cuirently active applet context is not 
the currently selected applet context, the method shall throw a SystemException with reason code of 
ILLEGAL_TRANSI£NT. If an attempt is made to access a transient object of CLEAR_ON_DESEZ«ECT type 
when the cuzrently active applet context is not the currently selected applet context, the JCRE shall throw a 
Securi tySxcep t ion. 

Applets that are part of the same package share the same group context Every applet instance from a package 
shares all its object instances with all other instances from the same package. (This includes transiem objects of 
both CLBAR_ON_RESET type and CI«EAR_ON_DESELECr type owned by these applet instances.) 

The transient objects of CLEAR_ON_DESELECT type owned by any applet instance within the same package 
shall be accessible when any of the applet instances in this package is the cuirently selected applet 
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7. Transactions and Atomicity 



A transaction is a logical set of updates of persistent data. For example, transferring some amount of money 
from one account to another is a banking transaction. It is important for transactions to be atomic: either all of 
me data fields are updated, or none are. The JCRE provides robust support for atomic transacticns so that card 
data is restored to its onginal pre-transaction state if the transaction does not complete normally This 
mechanism protects against events such as power loss in the middle of a transaction, and against program 
that might cause data corruption should all steps of a transaction not complete nonnally. 



7.1 Atomicity 

AtOTiicity defines how the card handles the contents of persistent storage after a stop, feilure. or &tal exception 
durmg an update of a single object or class field or array component If power is lost during the update, ST 
applet developer shall be able to rely on what the field or array component contains when power is restored. 

^li^"^ platftam guuantees that any iq>date to a single persistent object or class field will be atomic In 
addmon, the Java Card pUtlbrm provides single component level atomicity for persistent arrays. That is, if the 
anart card loses power dunng the update of a data element (field in an object/class or component of an array) 
that ^1 be preserved across CAD sessions, that data elemem will be restored to its previous value. 

Some methods also guarantee atomicity for block updates of multiple data elements. For example, die atomicity 
of the ot il . arraycopy method guarantees that either all bytes are oorrecdy copied or else the destination 
array IS restored to Its previous byte values. 

An applet might not require atomicity for airay updates. The Utll .arrayCopyNoxAtomic method is provided 
for this purpose. It does not use the transaction commit buffer even when called with a transaction in progress. 



7.2 Transactions 

An applet might need to atomically update several different fields or array components in several different 
objects. Either all updates take place correctly and consistently, or else all fields/components are restored to 
tneir previous values. 

The Java Card platform supports a transactional model in which an applet can designate the beginning of an 
atomic set of updates widi a call to the JCSystem.beginT^ansactlon method. Each object update after this 
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point is conditianally updated. The field or airay component upean to be updated-fcadinB the <;eid/».>v 
eonvonent l»ck yield, its latest conditional value-blrtie i^SSfa not y^«nS«S^ ^ 

'"•''"f^'''"™'"'-*^ ecsditsons! updKts sre eoraaittedtopasSstat 

storage. If power is Ion or if some odier system ftilute occms prior to the ^pletion of P»««~» 

JCSyatem. coamltTranaaeelon. all conditionally updated fields or amy comiMments are reonnd t« <h^r 
previous values If the applet encounters an imen»l prSSTem ordeddesT^i^STe^S^ 
programmancally undo conditional updates by calling JCSystw,. «bortTran.aetl«r^ 



7.3 Transaction Duration 

A Hansacticn always end. when the regains piogranunatic conirol upon return from the applet's select 
«lf r„ ' ^n?" ™* « » traisaction ends nonnaUy. "th anLp>«'8 

S ni^^lSrSj ST'?^??'^''^ or wfth an abortioa of the iiansactiao (either pro^ammatieally by the aiX. or 
by definilt by the JCRE). For more detaUs on transaaion abonion, r4r to i^^qdi 7.6. ^ 

[^"^l^^"^ * JCSystem-beglarranaactlon. and either 

a call to conraitTr anaact ion or an abonion of the iransactian. 



7.4 Nested Transactions 

^clIII?!! IT^'^l^'^^ ""^ tnmsactions arc not possible. There can be only one tnmsaction in 
progress at a time. If JCSystem.beginTransaction is called while a transaction is already in^progress. then 
a TransactionBxceptlonU thrown. «iuy m progress, men 

TTic^ystem . transactlonDepth method is provided to allow you to determine if a transaction is in 



7.5 Tear or Reset Transaction Failure 

Aen the JCRE Aall restore to thev previous values all fields and amy components conditionally upcb^skee 
the previous call to JCSyscam.beginTranaaetlon. ujiiHwi suw 

This u^ian is performed automatically by the JCRE when it reiniti^ze. the card after lecovetins ftoro the 
SS^^^'S^" "^^ detemines which of those ottfectt (If any) were oonditionally updated. 

Sl'Se'r^S^gJSTthlfc^"''"'"'^*^ 
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7.6 



Aborting a Transaction 



Transactions can be aborted either by an applet or by the JCRE. 



7.6,1 Programmatic Abortion 

If an applet encounters an internal problem or decides to cancel the transaction, it can programmatically undo 
conditional updates by calling JCSyatem .abortTransactlon. If this method is called, all conditionally 
updated fields and airay components ance the previous call to JCSystem.begxnTransaction are restored to 
their previous values, and the JCSystem. tranaactionDepth value is leset to 0. 



7,6.2 Abortion by the JCRE 

if an applet returns from the select, deaelect . proceaa , or install methods wiA a transaction in 
progress, the JCRE automatically aborts the transaction. Ifarenanfromanyof select, deaelect, process 
or Install methods occurs with a transaction in progress, the JCRE acts as if an exception was thrown. 



7.6.3 Cleanup Responsibilities of the JCRE 

Object instances created during the transaction that is being aborted can be deleted only if all references to these 
objects can be located and converted into null . The JCRE shall ensure that references to objects created 
during the aborted transaction are equivalent to a nu 1 1 reference. 



Only updates to persistent objects participate in the transaction. Updates to transient objects are never undone, 
regardless of whether or not they were ^inside a transaction.** 



Since platform resources are limited, the number of bytes of conditionally updated data that can be accumulated 
during a transaction is limited. The Java Card technology provides methods to detennine how much commit 
capacity is available on the implementation. The commit capacity represents an upper bound on the number of 
conditional byte iq>dates available. The actual number of conditional byte updates available may be lower due 
to management overhead 

An exception is thrown if the commit capacity is exceeded during a transaction. 



7.7 Transient Objects 



7.8 



Commit Capacity 
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8. API Topics 



The topics in this chapter complemem the requirements specified in the Jwta Card 2. i API Dn^ 2 
Specification. The first topic is the Java Card I/O fitnctionality, which is implemented entirety in the APDU class. 
The second topic is tfie API siq>porting Java Card security and cryptography. The JCSystem class encapsulates 
the API version level. 

Transactions within the API 

Unless specifically called out in the Java Card 2.1 API Specification, the implementation of the API classes 
shall not initiate or otherwise alter the state of a transaction if one is in progress. 

Resource Use within the API 

Unless specifically called out in die Jsva Card 2.1 API Specification, the implementation shall support the 
invocation of API instance methods, even when the owner of the object instance is not the cumntly selected 
applet In other words, unless specifically called out, the implemenution shall not use resources such as 
transient objects of CL£AICON_DESELECT type. 

Exceptions thrown by API classes 

All exception objects thrown by the API implementation ^1 be temporary JCRE Entry Point Objects. 
Temporary JCRE Entry Point Oiqects cannot be stored in class variables, instance variables or array 
components. (See 6.2.1) 



8.1 The APDU Class 

The APDU class encapsulates access to the ISO 78 1 6-4 based I/O across the card serial line. The APDU Oass is 
designed to be independent of the underlying I/O transport protocol. 

The JCRE may support T-O or T«l transport protocols or both. 

8.1.1 T=0 specifics for outgoing data transfers 

For compatibility widi legacy CAD/teiminals that do not support block chained mechanisms the APDU Class 
allows mode selection via the setOutgoingNoChaiiUng method. 
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8.1.1.1 Constrained transfers with no chaining 

When the no chaining mode of output transfer is requested by the applet by calling the 
setOutgoingKoChnining method, the foUowing protcco! sequence shall be followed. 



Note — when the no chaining mode is used, calls to die wait Ext exus ion method shall throw an 
APDUException with reason code ILLEGAL^USE. 



Notation 

Le CAD expected length. 

Lr " Applet response length set via setOutgoingZ«ength method. 

<INS> « the protocol byte equal to the incoming header INS byte, which indicates that all data bytes 
will be transferred next. 

<-n4S> " the protocol byte that is the complement of the incoming header INS byte, which indicates 
about 1 data byte being transferred next 

<SW1 ,SW2> - the response stanss bytes as in IS078 16-4. 

ISO 781&4CASE2 
Le = Lr 

1 . The card sends Lr bytes of output data using the standard T-0 <INS> or <'-INS> procedure 
byte mechanism. 

2. The card sends <SW1,SW2> completion status on completion of the Applet .process 
method. 



Lr<Le 

1 . The card sends <0x61,Lr> completion status bytes 

2. The CAD sends GET RESPONSE command with Le - Lr. 

3. The card sends Lr bytes of ou^ut data using the standard TH> <INS> or <«»INS> procedure 
byte mechanism. 

4. The card sends <SW1,SW2> completion status on completion of the Applet . process 
mcdiod* 

Lr>Lo 

1. The card sends Le bytes of ouQiut data using the standard T"0 <INS> or <'-INS> 
procedure byte mechanism. 

2. The card sends <0x61,(Lr-Le)> completion status bytes 

3. The CAD sends GET RESPONSE command with new Le <» Lr. 

4. The card sends (new) Le bytes of output data using the stiuidard T-0 <INS> or <-INS> 
procedure byte mechanism. 
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5. Rqieat steps 2-4 as necessary to send the remaining output data bytes (Lr) as required. 

6. The card sends <SW1,SW2> completion status on completion of the i^plet . process 
method. 

ISO 7816-4 CASE 4 

In Case 4, Le is deteranined after the following initial exchange: 

1. The card sends <0x61,Lr status bytes> 

2. The CAD sends GET RESPONSE conunand with Le <- Lr. 

The rest of the protocol sequence is identical to CASE 2 d es cribed above. 

If the ^let aborts early and sends less than Le bytes, zeros nuiy be sent instead to fill out the lengdi of the 
transfer expected by the CAD. 

8.1.1.2 Regular Otitput transfers 

When the no chaining mode of output transfer is not requested by the applet (that is, the se tout going 
method is used), the following protocol sequence shall be followed: 

Any ISO-78 16-3/4 compliant T-0 protocol transfer sequence may be used 



Note - The waitExtenslon method may be invoked by die qiplet between successive calls to sendBytes 
or sendBytesLong methods. The waitExtenslon method shall request an addhional work waiting time 
(ISO 78 1 6-3) using the 0x60 procedure byte. 

8.1.1.3 Additional T'^O requirements 

At any time, when the T-0 output tzansfer protocol is in use, and the AFDU class is awaiting a GET 
RESPONSE command from the CAD in reaction to a response status of <0x61, xx> from the card, if the CAD 
sends in a different command, the sendBytes or the sendBytesLong methods shall throw an 
APDUException with reason code NO_TO_6ET!IBSPONSE. 

Calls to sendBytes or sendBytesLong methods from this point on shall result in an APDUException with 
reason code XLLEGAL_USE. If an ZSOException is thrown by the applet after the NO_T0.6ETRESPONSE 
exception has been thrown, the JCRE shall discard the response status in its reason code. The JCRE shall restart 
APDU processing with the newly reodved command and resume APDU dispatching. 

8, 1 .2 T=l specifics for outgoing data transfers 

8 . 1 .2. 1 Constrained transfers with no chaining 

When the no chaining mode of output transfer is requested by the applet by callmg the 
setOutgoingNoChaining method, the following protocol sequence shall be followed: 

Notation 

Le - CAD expected length. 

Lr * Applet response length set via eetOutgolngLength method. 
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The <n»spm prM^^^ sequence shall not use block chaining. Specifically, the M-bit (more data bit) shall not be 
srt in the PCB of the Lblocks during die tnmsfers QSO 78IM>faod,er words, die adrt «^g (U 
bytes) shall be transferred in one Nblock. wttgwng mbult 

(If die a^Iet aborts cari y and sends less dian Lr bytes, zeros shall be sent instead to fill out die remaining 
length of the block.) ^ 

Note - When the no chaining mode is used, calls to die waitExteneion method shall throw an 
APDUException witii reason tode ILLEGAL^USE. 

8.1.2.2 Regular Output transfers 

When die no chaining mode of output transfer is not requested by die applet te die BetOutgoing mediod is 
used, die following protocol sequence shall be followed: 

Any ISO-78 1 6-3/4 cwnpliant T» 1 protocol transfer sequence may be used 

Note - TTie wait Ext civsion mediod may be invoked by die applet between suceesasve calls to sendBytes 
or oendBytefiLong mcdiods. The waitExtension mediod shall send an S-block command widi WTX 
r«iue« of INF units, which is equivalent to a request of 1 additional work waiting time in T«=0 mode. (Sec ISO 



8.2 The security and crypto packages 



The get Ins tance method in die following classes return an implementation instance in die context of the 
calling applet of the requested algorithm: 

javacard. security .MessageDigest 

j avaeard . security . Signature 

j avaeard . necuri^y . RandomData 

j avacardx. crypto . Cipher. 

An implementation of die JCRE may implement 0 or more of die algorithms listed in die API. When an 
algoridun diat is not implemented is requested diis mediod shall dirow a Crypt oExcept ion widi reason 
C0deKO_SXJCH_ALa0RITHM. 

In^aam^tms of the above classes shaU extend die corresponding base class and tmplemat all die abstract 
mediods. AU data allocation associated with die implementation instance shall be perfonned at die time of 
m^^jMostnictian to ensure diat any lack of required resources can be flagged early during die instalbtion of 

Sinulariy, the buiXdKey mediod of die j avaeard. security . keyBuilder class renims an 
implementation instance of die requested Key type. Tbe JCRE may implement 0 or more types of keys. When a 
key type diat IS not implemented is requested, die mediod shall dvow a CryptoBxception widi reason code 
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Implementations of key types shatt imptemem the associated interfiice. All data allocation assocUted vnth the 
key unplementanon »>nnce shaUbe peribmied at the time of insi».ee constructiaTwS^^S «y^of 
requifedresoorces can be flagged early dtving the installation of the applet ^ 



8.3 JCSystem Class 

In Java Card 2. 1, the getvcrsian method shall return (short) 0x0201 . 
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9. Virtual Machine Topics 



The topics in this chapter detail virtual machine specifics. 



9. 1 Resource Failures 



A lack of resources condition (such as heap space) which is recoverable shall result in a SystemBxception 
with reason code NO^RESOURCE. The factory methods in JCSys tern used to create transient anays throw a 
SystemBxception with reason code N0_TRAKS1ENT_SPACE to indicate bck of transient space. 

All other (non-recoverable) virtual machine errors such as stack overflow shall resuh in a vimial machine error 
These conditions shall cause the virnial machine to hah. When such a non-recoverable virtual machine error 
occurs, an implemenution can optionally require the card to be muted or blocked from further use. 
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10. Applet Installer 



Applet installation on smart cards using Java Card technology is a complex topic. The Java Card API 2 I is 
intoided to give JCRE implementen as much freedom as possible in their implonentations. However, some 
basic common specifications are required in order to allow Java Card applets to be installed without knowing 
the implementation details of a particular installer. 

This specification defines the concqit of an Installer and specifies minimal instaUation requirements in order to 
achieve interoperability across a wide range of possible InstaUer implementations. 

The Applet Installer is an optional part of the JCRE 2. 1 Specification. That is. an implementation of the JCRE 
does not necessarily need to include a post-issuance Installer. However, if implemented, the installer is required 
to support the behavior specified in section 9. 1 . 



10.1 The Installer 



The medwnisms necessary to install an applet on smart cards using Java Card technology are embodied in an 
on-card component called the Installer. 

To the CAD the Installer appears to be an applet. It has an AID, and it becomes the currcnUy selected applet 
when this AID is successfiilly processed by a SELECT command. Once selected, the InstaUer behaves in much 
the same way as any other applet 



• it receives all APDUs just like any other selected applet. 

• Its design specification prescribes the various kinds and formats of APDUs that it expects to receive along 
with the semantics of those commands under various pieoondttions. 

• It processes and responds to all APDUs that it receives. Incorrect APDUs are responded to with an error 
condition of some kind. 

• Whm another applet is selected (or when the card is reset or when power is removed from the card), the 
Installer becomes deselected and remains suspended until the next time that it is SELECTed. 



10.1.1 Installer Implementation 

The Installer need not be implemented as an applet on the card. The requirement is only that the Installer 
functionality be SELECTablc. The corollary to this requirement is that Installer componem shall not be able to 
be invoked when a non-lnstallcr applet is selected nor when no applet is selected. 
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Obviously, a JCRE implementer could choose to implement the Installer as an applet. If so, then the Installer 
might be coded to extend the J^pXec class and respond to invocatians of the aelecc, process, and 
deselect methods. 

But a JCRE implementer could also implement the Installer in other ways, as long as it provides the 
SELECTable behavior to the outside world. In this case, the JCRE implementer has the freedom to provide 
some other mechanism by which APDUs are delivered to the Installer code module. 



10.1.2 Installer AID 

Because the Installer is SELECTable, it shall have an AID. JCRE implementers are free to choose their own 
AID by which their Installer is selected. Multiple installers may be implemented. 



10.1.3 Installer APDUs 

The Java Card API 2. 1 does not specify any APDUs for the Installer. JCRE implementers are entirely free to 
choose their own APDU commands to direct their Installer in its work. 

The model is that the Installer on the card is driven by an installation program running on the CAD. In order for 
installation to suc cee d, this CAD installation program shall be able to: 

• Recognize the card. 

• SELECT the Installer on the card. 

• Drive the installation process by sending the appropriate APDUs to the card InsttUer. These APDUs will 
contain: 

> Authentication infonnation, to ensure that the installation is authorized. 

> The applet code to be loaded into the card's memory. 

> Linkage infinmation to link the applet code with code already on the card. 

> Instance initialization parameter data to be sent to the applet's inscal 1 method. 



The Java Card API 2. 1 does not specify the details of the CAD installation program nor the APDUs passed 
between it and the Installer. 



10.1.4 Installer Behavior 

JCRE implementers shall also define other behaviors of their Installer, including: 

• Whether or not installation can be aborted and how this is done, 

• What happens if an exception, reset, or power &il occurs during installation. 

• What happens if another applet is selected before the Installer is finished with its work. 

The JCRE diall guarantee that an applet will not be deemed suocessfiilly installed if: 

• the applet's install method throws an exception before successfiil return from the Applec . regiacer 
method. (Refer to paragraph 9.2.) 
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10.1.5 Installer Privileges 



Although an Installer may be implemented as an applet, an Insteller will typically recpiire access to features that 
are not available to **other applets. For example, depending on the JCRE implementer's implementation, the 
Installer will need to: 

• Read and write directly to memory, bypassing the object system and/or standard security. 

• Access objects owned by other applets or by the JCRE. 

• Invoke non^ny point methods of the JCRE. 

• Be able to involw the install method of a newly installed applet 

Again, it is up to each JCRE implementdr to determine the Installer implementation and supply such features in 
their JCRE implementations as necessary to support their Installer. JCRE implementen are also responsible for 
the security of such features, so that they are not available to nonnal applets. 



There is a single inter&ce between the installer and the applet that is being installed. After the Installer has 
correctly prepared the applet for execution (perfonned steps such as loading and linldng), the Installer shall 
invoke the applet's inst:all method This method is defined in the Applet class. 

The precise mechanism by which an applet's install method is invoked from the installer is a JCRE 
implementer-defined implementaticn detail. However, there shall be a context switch so thai any context- 
related operations performed by the install method (such as creating new objects) are done in the context of 
the new applet and not in the context of the Installer. The Installer shall also ensure that array objects created 
during applet class initialization (<clinit>) methods are also owned by the context of the new applet 

The installation of an applet is deemed complete if all steps are convicted without failure or an exception being 
thrown, up to and including successful return from executing the Applet . register method. At that point, the 
installed applet will be selectable. 

The maximum size of the parameter data is 32 bytes. And for security reasons, the bArray parameter is zeroed 
after the return (just as the APDU buffer is zeroed on retum from an applet's process method.) 



Other than the maximum size of 32 bytes, the Java Card API 2.1 does not specify anything about the contents 
of the installation parameter byte array segment This is fiiUy defined by the applet designer and can be in any 
format desired. In addidon, these installation parameters are intended to be opaque to the Installer. 

JCRE in^lementers dunild desipi thmr Installers so that it is possible for an inslallatioa program runnmg m a 
CAD to specify an arbitrary byte array to be delivered to the Installer. The InstaUer simply forwards this byte 
array to the target applet's install method in the hArray parameter. A typical implementation mis^t define a 
JCRE implementer-proprietary APDU command that has the semantics **call the applet's install method 
passing the contents of the accompanying byte array.** 



10.2 



The Newly Installed Applet 



10.2. 



1 Installation Parameters 
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11. API Constants 



Some of the API classes don*t have values specified for their constants in the Java Card API 2. J Reference. If 
constant values are not specified consistently by imptementers of this JCRE 2. 1 Specification, indusoy-wide 
interoperability is impossible. This chapter provides the required values for constants that are not specified in 
the Java Card API 2. 1 Reference. 

Class javacard.flrameworfcAPDU 

pu29lic static final byte PROTOCOL_T0 - 0; 
public static final byte PR0T0O0L_TI - 1$ 

Class jav8card.framewor1(APDU£xception 

ptiblic static final short ILL&GHLjaSE - li 

public static final short BUPFERjioaNDS • 2; 

pxiblic static final short BAD^uSOTH • 3; 

p\iblic static final short 10 BlUtOR • 4; 

public static final short KoIto.GBTRESPONSB - OxAA; 

Interface javacard.framewor1clS07816 

public final static short SWJKO ERROR - (short) 0x9 000; 
public final static short SH^BYTES^REMAINZNG.OO - 0x6100; 
public final static short SH KRONalLBNOTH - 0x6700; 

public static final short SH^SECORXTY^STATaS NOT SATISFIED • 0x6982; 

public final static short SK FILE XMVALXD - 0x6983; 

public final static short SH.DATaIiNVALID » 0x6984; 

public final static short SH_CX2KDITIOKS_N0T_SAnSFIED « 0x6985; 

public final static short SW_COMKAND NOT^AIXOMED • 0x6 986; 

public final static short SH_APPLET_SEI£Cr.FAIIiED • 0x6999; 

public final static short SW KROIIG DAXA - 0x6A80; 

public final static short SH_F0HC.»0T_SUPPORTSD - 0x6A81| 

public final static short SW_Fli«E_NOT_FoaMD - Ox6Aa3; 

public final static short SW RECORD NOT FOUMD « 0x6A63; 

public final static short SH^IMCGRRBCT P1P2 - 0x6A86; 

public final static short SWJHROHO.PIpI « 0x6B00i 

public final static short SH_OORRBCT L£3IGTH 00 - Ox6COO; 

public final static short SH^IKS^KOT^StTPPORTEO - Ox6DOO; 

public final static short SW^CLA^HOT^SUP PORTED ■ 0x6 EGO; 

public final static short SWJUta^wfm 0x6F00; 

public static final short SfCFILE.FOU. - 0x6A84; 

public final static byte OFFSET_CLA - 0; 

public final static byte OFFSET_INS • 1; 

public final static byte 0FFSET~P1 - 2; 

public final static byte 0FFSET^P2 - 3; 
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public final static byte OFFSET LC • 4; 

public final static byte OFPSET~CDATA- S; 

public final static byte CtA_XS07816 - OxOO; 

public final static byte ZNS~SEZ«ECT - (byte) 0xA4f 

public final static byte XNSlEXTEIUiAL^AUTHEKrXCllTE - (byte) 0x82; 

Class javacard.frameworkJCSystem 

public static final byte NOT A TRANSIENT OBJECT - 0; 
public static final byte CLEAR jON_R£SET - li 
public static final byte CLBAR~QN_DBSELBCT m 2< 

Class Javacard.framewortcPINExoeptton 

public static final abort XLLEGAIi.VALDB - if 

Class ]avacard.flramewort(.SystemException 

public static final short ILLEGAL^VALUB - 1; 
public static final short NO_TRAt€lENT.SPACE • 2; 
public static final short ILLEGAL TRAnIxENT « 3; 
public static final short XLLBGAL'aID « 4; 
public static final short NO.RESQURCB « 5; 

Class javacard.security.CryptoException 

public static final short ILLEGAL VALUE - 1; 
public static final short UNINITZALIZ£0_KEY - 
public static final short NO_SUCH_ALGORXTKM - 
public static final abort XMVALXb~INIT • 4; 
public static final short XLLEGAL'osS - S; 

Class Javacanl.securtty.K0yBuiIder 

piiblic static 
public static 
public static 
public static 
public static 
public static 
public static 
public static 
public static 
public static 
public static 
ptiblic static 
* public static 
public static 
public static 
public static 
public static 
pxUilic static 

Class javacard.secuiity.MessageDigest 

public static final byte ALG_SHA « 1; 
public static final byte AIG_MD5 « 2i 
public static final byte AL8^RXPEMD160 - 3; 

Class javacard.securtty.RandcmData 
public static final byte ALG_PSSllDO RAHDOM - it 
public static final byte ALO^SECORE^RAKDON » 2t 

Class Javacard .security. Signature 

public static final byte AL0_DES_MAC4_N0PAD . 1; 
public static final byte ALO.DSS MACS HOPAD • 2; 
public static final byte ALa2DESJ(AcOs09797_Hl • 3j 
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final byte TyPE_DES_TRAHSXENT_RBSET « li 

final byte TYPE_DES_TRANSXEOT'dE5ELECT - 2f 

final byte TyPE_DES - 3; ~ 

final byte TYPE RSA POBLXC » 4; 

final byte TYPE_RSA PRIVATE • 5; 

final byte TYPE RSA^'CRT PRIVATE - 6; 

final byte TYPB^tJSA'PDBLIC - 7; 

final byte TYPE_DSA_ PRIVATE - B; 

final short LENGTH DES « 64; 

final short LENQto'^DESS 2KEY • 128; 

final short LEIlSTK~DES3*3XEy « 192; 

final short LBNGTK RSA S12 - 512; 

final short LENaTK'~RSA3768 • 768 1 

final short LENGTH RSA 1024 - 1024; 

final short LENaTH''RSA"'2048 » 2048/ 

final short LENGIHJDSA 512-512; 

final short LENGTH DSA_768 » 768; 

final short LENaTKJDSA~1024 - 1024; 
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public atacic 

pxiblic static 

public static 

public static 

public static 

public static 

public static 

public static 

imblic static 

public static 

public static 

p\iblic static 

public static 

Class javacanJx.aypto.Cipher 

public static final byta AIia_DES_CBC_NOPAD - Ij 

public static final byte AIi32DES_CBC''ZS09797 Ml - 2; 

public static final byte ALO_PES"cBc2iS09797"'m2 « 3| 

public static final byte ALQJDES^CBC^PKCSS «~4i 

public static final byte Aia'^DES^ECB NOPAD « 5; 

public static final byte ALO'~D£S_ECB~IS09797 Ml - 6; 

public static final byte Ato"DBS_ECB~IS09797'"M2 - 7; 

public static final byte ALO_I>£S_ECB PKCS5 -"S; 

pxiblic static final byte iaajRSA_Jlsdl4BSB • 9; 

public static final byte AUajlSJi^FKCSl - 10; 

public static final byte MODE_DECRYPT - 1; 

public static final byte MQDE~ENCRYPT - 2f 



final byte ALQ_OES_MACe_ZS09797 Ml « 4 ; 
final byte ALo'dss MAC4^ZS09797'm2 • 5; 
final byte ALa~DBS~MAC6~XS09797"'M3 • 6i 
final byte AU3JDES_MAC43pkCSS -"7; 
final byte A1jOJ>ES_MACB"pKCS5 • 8; 
final byte ALg''rsa_SKA XS09796 • 9; 
fixial byte ALO~RSA_SKaIpkcsi ■ 10; 
final byte AIiG_R5A_MDS_PKCSl • 11; 
final byte ALO_RSA_RIPEMD160 XS09796 - 12; 
final byte ALC_RSaIrIPEMD16o"pKCS1 - 13; 
final byte ALO_DSA_SKA « 14/' 
final by^e MGOl SI(a« « 1; 
final by^e HODE'veRXFY • 2; 
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Glossary 



AID is an acronym for Application IDentificr as defined in ISO 7816-5. 

APOU is an acronym for Application Protocol Data Unit as defined in ISO 78 1 6-4. 

API is an acronym for Application Programming Intcrfece. The API defines calling conventions by which an 
application program accesses the operating system and other services. 

Applet within the context of this document means a Java Card Applet, which is die basic unit of selection, 
context, functionality, and security in Java Card technology. 

Applet developer refers to a person creating a Java Card applet using the Java Card technology spedfications. 

Applet firewall is the mechanism in the Java Card technology by which the VM prevents an applet from 
making unaudiorized accesses to objects owned by other applet contexts or die JCRE context, and reports or 
otherwise addresses the violation. 

Atomic operation is an operation that either completes in iu entirety (if the operation succeeds) or no part of 
the operation completes at all (if the operation foils). 

Atomicity refers to whether a particular operation is atomic or not and is necessary for proper data recovery in 
cases in v^ich power is lost or the card is unexpectedly removed from the CAD. 

ATR is an acronym for Answer to Reset. An ATR is a string of bytes sent by the Java Card after a reset 
condition. 

CAD is an acronym for Card Acceptance Device. The CAD is the device in wtuch the card is inserted. 
Cast is the explicit conversion fiom one data type to another. 

cJCK ts die test suite to verify the compliance of the implementation of the Java C&rd Technology 
specifications. The cJCK uses the JavaTest tool to run the test suite. 

Class is the prototype for an olgect in an object-oriented language. A class may also be considered a set of 
otyects that siiare a common structure and behavior. The structure of a class is determined by the class variables 
that represent the state of an ckjeet of that class and die behavior is given by a set of metfiods associated widi 
the class. 

Classes are related in a class hierarchy. One class may be a specialization (a subclass) of another (its 
superclass), it may have reference to other classes, and it may use other classes in a client-server relationship. 

Context (See Applet execution context) 

CnrrenUy acdve context The JCRE keeps track of die cunrendy acdve Java Card applet context. When a 
virtual mediod is invoked on an object, and a context switch is required and permitted, die currently active 
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context is changed to oorrcspood to the applet context that owns the c^ect When that method returns, the 
previous context is restored, invocations of static methods havis no effect on the cunently active context The 
cuncndy active context and sharing status of an object together detennine if access to an object is pennissible. 

CurrenUy selected applet The JCRE keeps track of the currenUy selected Java Card applet Upon receiving a 
SELECT command with this applet's AID, die JCRE makes this applet die currcndy selected applet The JCRE 
sends all APDU commands to the cunently selected applet 

EEPROM is an acronym for Electrically Erasable* Programmable Read Only Memory. 
Firewall (see Applet Firewall). 

Framework is die set of classes that implement the API. This includes core and extension packages. 
Responsibilities include dispatching of APDUs. applet selectmn, managing atomicity, and installing applets. 

Garbage eoUectioo is the process by which dynamically allocated storage is automitiGaUy reclaimed during 
the execution of a program. 

Instance variables, also known as lields, represent a portion of an object's internal state. Each object has its 
own set of instance variables. Otgects of the same class will have die same instance variables, but each olgect 
can have different values. 

Instantiation, in object<^ented progiaixixning, means to produce a particular object from its class template. 
This involves allocation of a dau structure with the types specified by the template, and inittallzation of 
instance variables with either de&ult values or those provided by the class's oonsiruaor function. 

JAR is an acronym for Java Archive. JAR is a platfbrm-indqsendent file fonnat that combines many files into 
one. 

Java Card Ranttme Eiiviranment (JCRE) consists of the Java Card Virtual Machine, die framework, and die 
associated nadve methods. 

JC2IRI is an acronym for the Java Card 2. 1 Reference Implementation. 

JCRE implementer refers to a person creating a vendor^specific implementation using the Java Card API. 

JCVM is an acronym for the Java Card Virtual Machine. The JCVM is the foundation of the OP card 
architecture. The JCVM executes byte code and manages classes and objects, it enforces separation between 
applications (firewalls) and enables secure data sharing. 

JDK is an acronym for Java Development Kit The JDK is a Sun hfficrosystems. Inc. product duU provides the 
environment required for propanuning in Java. The JDK is available for a variety of platforms, but most 
notably Sun Solaris and Microsoft Windows*. 

Method is die nsme given to a procedure or routine, associated with one or more classes, in object-oriented 
languages. 

Namespace is a set of names in which all names are unique. 

Object-Orfcnted is a programming mediodology based on die concept of an object, which is a data strucnire 
encapsulated widi a set of routines, called methods^ which operate on the data. 

Objects, in object-oriented programming, are unique instances of a data structure defined according to the 
template provided by its class. Each object has its own values for the variables belonging to its class and can 
respond to the messages (methods) defined by its class. 
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Package is a namespace within the Java programming language and can have classes and inter&ccs. A package 
is the smallest unit within the Java prograDuning language. 

Perslsteat object Persistent cdgects and their vahjes persist frcm one CAD session to the next, indefinitely. 
Objects arc persistent by de&uit. Persistent object values are updated atomically using firansactions. Hie tenn 
persistent does not mean there is an object-oriented database on the card or that objects are 
serialized/deserialized, just that the otgects are not lost when the card loses power. 

Shareable Interface Defines a set of shared inter&oe methods. These interfoce methods cai} be invoked from 
one applet context when die object implementing diem is owned by anodier applet context 

Shareable Interface object (SIO) An object that implements the shareable interface. 

Transaction is an atomic operation in which the developer defines the extent of the operation by indicating in 
the program code the beginning and end of the transaction. 

Transient object. The values of transient olgects do not persist from one CAD session to the next, and are reset 
to a defauh state at specified intervals. Updates to the values of transient objects are not atomic and are not 
affected by transacitons. 
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l/S/99 12:49 PM Havnor: Stuff: JCRE D2 14DEC98: READ-ME-JCRE21-DF2.txt Page 1 
Date: 16 December 1998 
Dear Java Card Licensee, 

JCR£21-DF2-14DEC98^ip contains a second draft of the Java Card 2.1 
Runtime Environment specification, dated December 14, 1998, for 
Licensee review and conunent. We have worked incorporate and clarify 
the document based upon the review feedback we've received to date. 

Complete contents of the zip archive are as follows: 

READ-ME-JCRE2 1 .DF2.txt - This READ ME text file 

JCRE2 l-DF2.pdf - "Java Card Runtime Environment (JCRE) 

2.1 Specification*' in PDF format 
JCRE21-DF2-changebar.pdf - The revised document with change bars 

from previous version for ease of review. 

Summary of changes: 

1 . This is now a draft 2 release and will be published on the public web site shortly. 

2. New description of temporary JCRE Entry Point Objects has been introduced for purposes 
of restricting unauthorized access. 

Firewall chapter 6.2.1 . 

3. Global arrays now have added security related restrictions similar to temporary JCRE 
Entry Point objects. Firewall chapter 

6.2.2. 

4. Detailed descriptions of the bytecodes with respect to storing restrictions for temporary 
JCRE Entry Point Objects and 

Global arrays added. Chapter 6.2.8. 

5. General statement about JCRE owned exception objects added in chapter 8. 

6. Corrected description of Virtual machine resource failures In transient ftictory methods. 
Chapter 9.1. 

The "Java Card Runtime Environment 2.1 Specification" specifies the minimum behavior and runtime 
environment for complete Java Card 2.1 implementation, as referred to by the Java Card APT 2.1 and Java Card 
2.1 Virtual Machine Specification documents. This specification is required to ensure compatible operation of 
Java Card applets. The purpose of this specification document is to bring all the JCRE elements together in a 
concise manner as part of the Java Card 2.1 specification suite. 

Please send review comments to <javaoem-javacard@sun.com> or to my address as below. On behalf of the 
Java Card team, I look forward to hearing from you. 

Best, 

Godfrey DiGiorgi 

Godfrey DiGiorgi - godfrey.digiorgi@eng.sun.com 

OEM Licensee Engineering 

Sun Microsystems / Java Software 

+1 408 343-1506 - FAX +1 408 517-5460 
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What is claimed is: 

1. A small footprint device comprising: 

a. at least one processing element; 

b. memory, 

c. a context barrier using said memory for isolating program modules from one 
another; and 

d. a global data structure for permitting one program module to access 
information from another program module across said context barrier. 

2. The small footprint device of claim 1 in which said context barrier allocates 
separate name spaces for each program module. 

3. The small footprint device of claim 2 in which at least two program modules can 
access said global data stmcture even though they are located in different respective name 
spaces. 

4. The small footprint device of claim 1 in which said context barrier allocates 
separate memory spaces for each program module. 

5. The small footprint device of claim 4 in which at least two program modules can 
access said global data stmcture even though they are located in different respective 
memory spaces. 

6. The small footprint device of claim 1 in which said context barrier enforces 
security checks on at least one of a principal, an object and an action. 

7. The small footprint device of claim 6 in which at least one security check is 
based on partial name agreement between a principal and an object. 

8. The small footprint device of claim 7 in which at least one program can access 
said global data stmcture without said at least one security check. 

9. The small footprint device of claim 6 in which at least one security check is 
based on memory space agreement between a principal and an object. 
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10. The small footprint device of claim 9 in which at least one program can access 
a global data structure without said at least one security check. 

11. A method of operating a small footprint device, comprising (he step of 
separating program modules using a context barrier and permitting access to information 
across the context barrier using a global data structure. 

12. The method of claim 1 1 in which the context barrier will not permit a principal 
to perform an action on an object unless both principal and object are part of the same 
context unless the request is for access to a global data structure. 

13. A method of permitting access to information on a small footprint device from a 
first program module to a second program module separated by a context barrier, 
comprising the step of creating a global data structure which may be accessed by at least 
two program modules. 

14. A method of communicating across a context barrier separating program 
modules on a small footprint device, comprising the steps of: 

a. creating a global data stmcture; 

b. permitting at least one program module to write information to said global data 
structure; and 

c. having at least one other program module read information from said global data 
structure. 

15. A computer program product, comprising: 

a. a memory medium; and 

b. a computer controlling element comprising instructions for implementing a 
context barrier on a small footprint device and for bypassing said context barrier using a 
global data structure. 

16. The computer program product of claim 15 in which said medium is a carrier 

wave. 

17. A computer program product, comprising: 
a. a memory medium; and 
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b. a computer controlling element comprising instructions for separating a plurality 
of programs on a small footprint device by running them in respective contexts and for 
permitting one program to access information fix>m another program by way of a global 
data structure. 

18. The computer program product of claim 17 in which said mediimi is a carrier 

wave. 

19. A carrier wave cairying instructions for implementing a global data stmcture 
for bypassing a context bairier on a small footprint device over a communications link. 

20. A carrier wave cairying instructions over a communications link for separating 
a plurality of programs on a small footprint device by running them in respective contexts 
and for permitting one program to access information fix>m another program using at least 
one global data structure. 

21. A method of transmitting code over a network, comprising the step of 
transmitting a block of code from a server, said block of code comprising instmctions for 
implementing a global data structure for bypassing a context barrier on a small footprint 
device over a communications link. 
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